skill-creator について
gbrain のスキルを作成し、スキル群を拡張するエージェント向けのスキルです。未対応のニーズとトリガーの重複を確認し、準拠した SKILL.md を作成して、マニフェストとリゾルバーを更新しテストします。
主な機能
- 01既存スキルが扱わないニーズの特定
- 02スキルトリガーの重複確認
- 03規約に沿った SKILL.md の作成
- 04スキルマニフェストとリゾルバーの更新
- 05スキル準拠テストの実行
活用シーン
- 01未対応のユーザー意図に向けたスキル作成
- 02新しいスキルと既存機能の重複確認
- 03スキルをルーティングとマニフェストに追加
- 04スキルファイルの準拠テスト
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ garrytan/ gbrain --skill skill-creatorインストール後、Claude Code で/skill-creatorを入力して読み込まれたか確認します。
詳細
スキル作成
契約
このスキルでは、以下を保証します。
- 新しいスキルが適合性基準(フロントマターと必須セクション)に従っていること
- MECE チェック:既存スキルのトリガーと重複していないこと
- Manifest.json が更新されていること
- RESOLVER.md にルーティングエントリが追加されていること
- スキルが適合性テスト(
bun test test/skills-conformance.test.ts)に合格すること
フェーズ
- ギャップを特定します。 どのような機能が不足していますか? どのようなユーザーの意図に対応するスキルがありませんか?
- MECE チェックを行います。
skills/manifest.jsonとskills/RESOLVER.mdを確認します。既存のスキルですでに対応できていますか? 対応できている場合は、新しいスキルを作成するのではなく、既存のスキルを拡張します。 - SKILL.md を作成します。 次のテンプレートを使用します。
---
name: {skill-name}
version: 1.0.0
description: |
{One paragraph describing what the skill does and when to use it.}
triggers:
- "{trigger phrase 1}"
- "{trigger phrase 2}"
tools:
- {tool1}
- {tool2}
mutating: {true|false}
---
# {Skill Title}
## Contract
{What this skill guarantees — 3-5 bullet points}
## Phases
{Numbered workflow steps}
## Output Format
{What good output looks like}
## When it fails
Follow the [agent operator protocol](../conventions/agent-operator-protocol.md) for any gbrain error `code`, exit code, `[AGENT]` block or notice block. Specific to this skill:
{2-5 concrete failures this skill hits — error codes, refusals, notices — and what to do and tell the user}
## Anti-Patterns
{What NOT to do — 3-5 items}
## Tools Used
{GBrain operations used, with descriptions}
- マニフェストに追加します。
skills/manifest.jsonを更新し、名前、パス、説明を追加します。 - リゾルバーに追加します。
skills/RESOLVER.mdを更新し、適切なカテゴリにルーティングエントリを追加します。 - 検証します。
bun test test/skills-conformance.test.tsを実行して、新しいスキルが合格することを確認します。
出力形式
新しい skills/{name}/SKILL.md ファイルと、更新済みのマニフェストおよびリゾルバー。
失敗した場合
gbrain のエラー code、終了コード、[AGENT] ブロック、または notice ブロックが発生した場合は、エージェント運用者プロトコルに従ってください。このスキル固有の対応は次のとおりです。
bun test test/skills-conformance.test.tsが失敗する場合:新しい SKILL.md に必須セクション(Contract、Anti-Patterns、Output Format、When it fails)またはフロントマターが不足しています。追加して再実行してください。gbrain check-resolvableでスキルに到達できないと報告された場合:適切なカテゴリに RESOLVER の行を追加し、再実行してください。
アンチパターン
- 既存のスキルと重複するスキルを作成する(MECE に違反します)
- 既存のスキルとの MECE チェックを省略する
- フロントマターにトリガーを含めずにスキルを作成する
- manifest.json と RESOLVER.md を更新しない
- Anti-Patterns セクションを含めずにスキルを作成する
コメント
Markdown 対応