mcpField
S
skill-development

skill-development

github.com/letta-aiエージェントワークフロー152153 回インストール4 週間前に更新
リポジトリ

skill-development について

再利用可能なエージェントスキルの作成、整理、検証、投稿を支援するガイドです。手順やリソースの構成方法と、一般化できる知識かどうかの判断基準を説明します。

主な機能

  1. 01SKILL.md の構成とメタデータの定義
  2. 02段階的な情報開示による内容整理
  3. 03スクリプトによる初期化、パッケージ化、検証
  4. 04再利用可能な知識の評価と投稿

活用シーン

  1. 01繰り返し使うワークフロー向けのスキル作成
  2. 02配布用スキルのパッケージ化
  3. 03共有ナレッジベースへの汎用的な解決策の投稿

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/letta-ai/skills --skill skill-development

インストール後、Claude Code で/skill-developmentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
references/
contribution-examples.md
pr-workflow.md
progressive-disclosure-research.md
recognizing-learnings.md
validation-criteria.md
scripts/
init_skill.py
package_skill.py
quick_validate.py

詳細

スキルの開発

効果的なスキルを作成し、コミュニティのナレッジベースに提供するためのガイドです。

このスキルを使用する場面

スキルの作成：

  • 特定の分野やワークフロー向けに新しいスキルを構築するとき
  • 既存のスキルを改善するために更新するとき
  • 配布用にスキルをパッケージ化するとき

スキルの提供：

  • 理解するのにかなりの時間がかかったことを発見したとき
  • 既存のスキルの手順が不十分だったり、誤った方向に導いたりしたとき
  • 文書化されていない同じ問題を繰り返し解決しているとき

パート 1：スキルの作成

スキルの構成
skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation loaded as needed
    └── assets/       - Files used in output
SKILL.md の要件
---
name: skill-name
description: What this skill does. Use when [triggers]. 
---

# Skill Name

[Instructions in imperative form...]

メタデータのルール：

  • name：小文字、ハイフン、動名詞形（例：creating-skills）
  • description：動作を表す動詞で始め、「Use when [triggers]」で終える
文体

二人称ではなく、命令形／不定詞形（動詞を先頭に置く）で記述します。

  • ✅ 「X を達成するには、Y を実行する」
  • ❌ 「X を実行する必要があります」
段階的な情報開示

SKILL.md は簡潔に保ちます（5k 語未満）。詳細な内容は references/ に移動します。

  1. メタデータ（約100語）- 常にコンテキストに含まれます
  2. SKILL.md 本文（5k 語未満）- スキルが該当したときに読み込まれます
  3. リファレンス（上限なし）- エージェントが必要に応じて読み込みます
スクリプト

次のようなタスクにはスクリプトを含めます。

  • 繰り返し書き直される
  • 決定論的な信頼性が求められる
  • 大幅なトークンの節約につながる

パート 2：スキルの提供

基本方針

このリポジトリは生きたナレッジベースです。スキルには、多くのエージェントに役立つ汎用的な知識を含める必要があります。プロジェクト固有の設定や個人的な好みは含めません。

提供する内容
✅ 提供する❌ 提供しない
3 回以上見られるパターン一度限りの解決策
汎用的な API／ツールのパターンプロジェクト固有の設定
実績のある回避策個人的な好み
既存のスキルにある不足箇所すでにほかで文書化されている内容
検証チェックリスト

提供する前に、次の点を確認します。

  • 特定の状況を超えて一般化できますか？
  • このパターンを複数回目にしたことがありますか？
  • 個人的な好みではなく、実際の不足箇所に対応していますか？
  • まったく異なるプロジェクトに取り組むエージェントにも役立ちますか？
提供の手順
  1. 認識する - 作業中にパターンに気づきます（時間の投入、繰り返し、修正）
  2. 検証する - そのパターンが一般的なものであり、特定の状況に限られないことを確認します
  3. ブランチを作成する - add/skill-name または fix/skill-name
  4. PR を送信する - 根拠と証拠を含む明確な説明を記載します

詳しい PR の手順については、references/pr-workflow.md を参照してください。

スクリプト

  • scripts/init_skill.py - スキルのディレクトリ構成を初期化します
  • scripts/package_skill.py - 配布用にスキルをパッケージ化します
  • scripts/quick_validate.py - SKILL.md の形式を検証します

リファレンス

  • references/recognizing-learnings.md - 価値ある学びを見つけるパターン
  • references/validation-criteria.md - 詳細な検証ガイドライン
  • references/pr-workflow.md - PR の手順とテンプレート
  • references/contribution-examples.md - 実際の提供例
  • references/progressive-disclosure-research.md - スキル構成に関する調査

コメント

Markdown 対応