skill-developer

スキル開発

MCP パイプラインをラップするスキルも含め、新しい Claude Code スキルを作成するためのメタスキルです。

使用するタイミング

• 「X 用のスキルを作成して」
• 「新しいスキルの作成を手伝って」
• 「このスクリプトをスキルにして」
• 「スキルの作成方法を教えて」

スキルの構造

スキルは .claude/skills/<skill-name>/ に配置します。

.claude/skills/my-skill/
├── SKILL.md          # Required: Main skill definition
├── scripts/          # Optional: Supporting scripts
└── templates/        # Optional: Templates, examples

SKILL.md の形式

---
name: skill-name
description: Brief description (shown in skill list)
allowed-tools: [Bash, Read, Write]  # Optional: restrict tools
---

# Skill Name

## When to Use
[When Claude should discover this skill]

## Instructions
[Step-by-step instructions for Claude to follow]

## Examples
[Usage examples]

MCP パイプラインスキルの作成

新しい MCP チェーンスクリプトを作成し、スキルとしてラップするには、次の手順に従います。

ステップ 1：テンプレートを使用する

multi-tool-pipeline テンプレートをコピーします。

cp $CLAUDE_PROJECT_DIR/scripts/multi_tool_pipeline.py $CLAUDE_PROJECT_DIR/scripts/my_pipeline.py

テンプレートのパターンを参照します。

cat $CLAUDE_PROJECT_DIR/.claude/skills/multi-tool-pipeline/SKILL.md
cat $CLAUDE_PROJECT_DIR/scripts/multi_tool_pipeline.py

ステップ 2：スクリプトをカスタマイズする

必要な MCP ツールをチェーンするように、新しいスクリプトを編集します。

async def main():
    from runtime.mcp_client import call_mcp_tool
    args = parse_args()

    # Chain your MCP tools (serverName__toolName)
    result1 = await call_mcp_tool("server1__tool1", {"param": args.arg1})
    result2 = await call_mcp_tool("server2__tool2", {"input": result1})

    print(result2)

ステップ 2：スキルを作成する

.claude/skills/my-pipeline/SKILL.md を作成します。

---
name: my-pipeline
description: What the pipeline does
allowed-tools: [Bash, Read]
---

# My Pipeline Skill

## When to Use
- [Trigger conditions]

## Instructions

Run the pipeline:

\`\`\`bash
uv run python -m runtime.harness scripts/my_pipeline.py --arg1 "value"
\`\`\`

### Parameters
- `--arg1`: Description

## MCP Servers Required
- server1: For tool1
- server2: For tool2

ステップ 3：トリガーを追加する（任意）

.claude/skills/skill-rules.json に追加します。

{
  "skills": {
    "my-pipeline": {
      "type": "domain",
      "enforcement": "suggest",
      "priority": "medium",
      "description": "What it does",
      "promptTriggers": {
        "keywords": ["keyword1", "keyword2"],
        "intentPatterns": ["(pattern).*?(match)"]
      }
    }
  }
}

参考ファイル

詳細については、次のファイルを参照してください。

cat $CLAUDE_PROJECT_DIR/.claude/rules/skill-development.md
cat $CLAUDE_PROJECT_DIR/.claude/rules/mcp-scripts.md

クイックチェックリスト

• SKILL.md にフロントマター（name、description）がある
• 「使用するタイミング」セクションが明確である
• 手順をそのままコピーして貼り付けられる
• 必要に応じて MCP サーバーが文書化されている
• skill-rules.json にトリガーが追加されている（任意）

このリポジトリの例

パターンを確認するには、既存のスキルを参照してください。

ls $CLAUDE_PROJECT_DIR/.claude/skills/
cat $CLAUDE_PROJECT_DIR/.claude/skills/commit/SKILL.md
cat $CLAUDE_PROJECT_DIR/.claude/skills/firecrawl-scrape/SKILL.md