skill-creator について
プログレッシブディスクロージャー方式で Agent Skills を作成するスキルです。ディレクトリ構成、メタデータ、基本指示、必要に応じて読み込む参考資料を案内します。
主な機能
- 013段階のスキル読み込みを説明
- 02スキルのディレクトリとファイル作成を案内
- 03SKILL.md の例を掲載
- 04参考資料を列挙
活用シーン
- 01新しい Agent Skill の作成
- 02詳細なガイドの参考資料への整理
- 03スキルのメタデータとトリガー語の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hotovo/ aider-desk --skill skill-creatorインストール後、Claude Code で/skill-creatorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/agent-skills-resources.mdcli-reference.mddevelopment-process.mdquick-start.mdskill-examples.mdwriting-guide.md詳細
スキルクリエイター
段階的な情報開示を活用して、効果的なエージェントスキルを作成します。
スキルを作成するタイミング
次のような状況に気づいたら、スキルを作成してください。
- 会話をまたいでコンテキストが繰り返される
- ドメインの専門知識が繰り返し必要になる
- エージェントが自動的に把握しておくべき、プロジェクト固有の知識がある
段階的な情報開示
スキルは3つのレベルで読み込まれます。
- メタデータ(約27トークン) - トリガー用の YAML フロントマター
- 指示(680トークン未満) - コアパターンを記載した SKILL.md の本文
- リソース(無制限) - 必要に応じて読み込む references/、scripts/、assets/
重要:レベル1と2は簡潔に保ちます。詳細はレベル3に移してください。
クイックワークフロー
- スキルのディレクトリを作成します:
.aider-desk/skills/my-skill/ - YAML フロントマター(
name、description)と本文の指示を含むSKILL.mdを作成します - 必要に応じて、詳細なドキュメントを
references/に追加します - 確認します:トリガーキーワードを入力すると、スキルがアクティブなスキルのサイドバーに表示されます
スキルが読み込まれない場合
YAML の構文が正しいこと、name が小文字とハイフンで構成されていること、description にユーザーが使いそうなトリガー語が含まれていることを確認してください。
SKILL.md の例
---
name: deploy-helper
description: Deploy AiderDesk builds to staging and production environments. Use when deploying, releasing, or publishing builds.
---
# Deploy Helper
Build and deploy AiderDesk to target environments.
## Steps
1. Run `npm run build` to generate production artifacts
2. Verify build output exists in `dist/`
3. Deploy to staging: `./scripts/deploy.sh staging`
4. Verify deployment: check health endpoint returns 200
## Troubleshooting
- Build fails: check `tsconfig.json` paths and run `npm run typecheck`
## References
- [environments.md](references/environments.md) - Environment configs
構成
my-skill/
├── SKILL.md # Core instructions + metadata
├── references/ # Detailed docs (loaded as needed)
├── scripts/ # Executable operations
└── assets/ # Templates, images, files
参考資料
- quick-start.md - 初めてのスキルを 作成する
- writing-guide.md - 効果的なスキルの 作成方法
- development-process.md - ステップごとのワークフロー
- skill-examples.md - パターンと 例
- cli-reference.md - CLI ツールの使用方法
- agent-skills-resources.md - アーキテクチャとベストプラクティス
コメント
Markdown 対応