yazelin/agent-skill-starter

agent-skill-starter は何をしますか？

エージェントスキルの構築を学べます——アドホックなプロンプトから、パッケージ化され自動トリガーされる Claude Code スキル、さらには決定論的なヘルパースクリプトまでを網羅します。

はじめに

このリポジトリは、AIエージェント（特にClaude Code）向けのカスタムスキルを作成するための出発点です。以下の段階を順に学ぶことができます：

1. アドホックなプロンプト
2. 構造化されたプロンプトテンプレート
3. 自動トリガー設定
4. 決定論的なヘルパースクリプト

前提条件

• Claude Code がインストールされていること
• Node.js 16+ または Python 3.8+
• 基本的なコマンドライン操作の知識

クイックスタート

# リポジトリをクローン
git clone https://github.com/yazelin/agent-skill-starter.git
cd agent-skill-starter

# スキルをインストール
claude skills install ./my-skill

スキルの構造

my-skill/
├── SKILL.md          # スキルのメイン定義
├── package.json      # 依存関係とメタデータ（Node.jsの場合）
├── helpers/          # ヘルパースクリプト
│   └── generate.sh
└── tests/            # テスト
    └── skill.test.js

自動トリガーの設定

SKILL.md 内で triggers セクションを定義することで、特定の条件でスキルが自動的に実行されるように設定できます：

triggers:
  - pattern: "deploy"
    action: "run:helpers/deploy.sh"
  - pattern: "generate report"
    action: "run:helpers/generate-report.sh"

決定論的ヘルパースクリプト

ヘルパースクリプトを使用すると、スキルの動作を決定論的に制御できます。例えば、helpers/generate.sh は以下のように構成します：

#!/bin/bash
# このスクリプトは常に同じ結果を生成します
set -euo pipefail
echo "Hello from deterministic helper"

テスト

# スキルのテストを実行
npm test

リソース

• Claude Code ドキュメント
• Agent Skill のベストプラクティス

ライセンス

MIT