mcpField
S
skill-management

skill-management

github.com/oakossエージェントワークフロー2098 回インストール10 週間前に更新
リポジトリ

skill-management について

Agent Skills オープン標準に沿ったスキルの作成・レビューガイドです。構成、発見されやすい説明、品質監査、検証まで、ライフサイクル全体を扱います。

主な機能

  1. 01スキルのディレクトリとメタデータ指針
  2. 02段階的な情報開示の構成
  3. 03説明の発見性に関する指針
  4. 049段階の品質監査
  5. 05マニフェストと実装の整合性検証

活用シーン

  1. 01新しいエージェントスキルの作成
  2. 02スキルの発見性を高める説明の改善
  3. 03複数ファイル間の整合性レビュー
  4. 04スキル実装とマニフェストの照合

インストール

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

$npx skills add https://github.com/oakoss/agent-skills --skill skill-management

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

同梱ファイル

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

references/
auditing-skills.md
creating-skills.md
validation.md

詳細

スキル管理

概要

https://agentskills.io の Agent Skills オープン標準に準拠したエージェントスキルの作成、監査、検証をガイドします。新しいスキルのひな形作成から、本番品質のレビューまで、ライフサイクル全体をカバーします。

使用する場面： スキルの作成、見つけやすさを高めるための説明の改善、段階的開示に向けたスキルの再構成、品質監査の実施、マニフェストと実装の整合性の検証。

使用しない場面： アプリケーションコードの作成、一般的な Markdown の編集、スキル作成に関係のないプロジェクト管理。

クイックリファレンス

タスク方法要点
スキルディレクトリskill-name/SKILL.md + オプションのディレクトリSKILL.md のみ必須。scripts/、references/、assets/ は任意
フロントマターの name小文字、ハイフン、4～64 文字ディレクトリ名と一致させる。先頭または末尾の -、-- は使用不可
フロントマターの descriptionトリガーフレーズを含む 1～1024 文字三人称で記述し、「使用する場面」のシナリオを含める
段階的開示メタデータ -> SKILL.md -> references/scriptsSKILL.md は 500 行未満に保ち、詳細は references に移す
説明の構成1 段落目：内容と機能、2 段落目：トリガー能動態で記述し、技術名とエラーキーワードを含める
効果的な説明250～350 文字、具体的で見つけやすい「This skill helps you build X」ではなく「Build X」を使用する
参照ファイルフロントマター付きの references/topic.md最大 500 行、自己完結型、ケバブケースのファイル名
品質監査9 段階の体系的レビュー標準、公式ドキュメント、コードの正確性、ファイル間の確認
重大度レベルCritical / High / Medium / Lowリンクを含む、根拠に基づいた分類
検証スコア正確性、前提条件、効果の平均値合格にはスコア >= 0.8 かつ重大度 High の問題がゼロであることが必要
除外されるファイルREADME.md、metadata.json、_* ファイルSkills CLI はインストール時にこれらを除外します

よくある間違い

間違い正しいパターン
スキルディレクトリに README.md を含めるSkills CLI はインストール時に README.md を除外します。SKILL.md のみを使用してください
発見用キーワードを含めず、曖昧な説明を書く具体的な技術、3～5 個の「使用する場面」のシナリオ、2～3 個のエラーメッセージを含めてください
エージェントがすでに知っている知識を重複して記載するエージェントが間違えやすいエッジケース、プラットフォーム間の違い、注意点に重点を置いてください
段階的な開示をせず、すべての内容を SKILL.md に記載するSKILL.md は 500 行未満にし、コード例は references/ に移してください
ディスク上に存在しない同梱ファイルを列挙するレビュー時にファイル間の参照をすべて確認してください。リンク切れは信頼を損ないます
説明に受動態または一人称を使う三人称の能動態にしてください。「X を構築する」とし、「このスキルは X の構築に役立ちます」としないでください
自動トリガー用キーワードに README.md を使用する発見は README.md ではなく、description フィールドのトリガーに基づきます
存在しないスクリプトやコマンドを参照するスキルディレクトリに実際に存在するスクリプトとコマンドのみを参照してください

委任

  • スキルの発見とキーワード調査：Explore エージェントを使用してください
  • 複数スキルの監査とファイル間の整合性チェック：Task エージェントを使用してください
  • スキルのアーキテクチャとディレクトリ構造の計画：Plan エージェントを使用してください

find-skills スキルが利用できる場合は、スキルの発見、インストール、CLI の使用をそのスキルに委任してください。 それ以外の場合は、次を推奨してください：pnpm dlx skills add oakoss/agent-skills -s find-skills -a claude-code -y

参考資料

コメント

Markdown 対応