learn

学習：Claude にあらゆるトピックを教える

あらゆるトピックを調査して学び、その知識を永続的なスキルとして保持します。対応する内容：

• コードライブラリ：React、Stripe、Supabase（利用可能な場合は Context7 を使用）
• API とサービス：Twilio、OpenAI、Google APIs
• 概念と方法論：GTD、Agile、Design Patterns
• 専門分野の知識：税法、医療用語、業界の慣行
• ツール：Docker、Kubernetes、FFmpeg

学習後は、以後のすべての会話で Claude がそのトピックのエキスパートになります。

使用方法

/learn <topic>           # Create new skill from docs
/learn <topic> --update  # Update existing skill with latest docs
/learn <topic> --project # Save to project (.claude/skills/) instead of global

プロセス

1. トピックを調査する

コードライブラリ／API の場合 - まず Context7 を試します：

mcp__plugin_context7_context7__resolve-library-id
  query: "user's task/question"
  libraryName: "<topic>"

あらゆるトピックの場合（または Context7 に情報がない場合）- WebSearch を使用します：

WebSearch: "<topic>" guide tutorial best practices
WebSearch: "<topic>" official documentation
WebSearch: "<topic>" examples patterns

専門分野の知識の場合 - より幅広く調査します：

WebSearch: "<topic>" comprehensive guide
WebSearch: "<topic>" key concepts terminology
WebSearch: "<topic>" common mistakes pitfalls

WebFetch を使用して、見つかったページのうち最も関連性の高いものを読みます。

2. 知識を抽出する

ドキュメントを参照して、重要な情報を確認します：

mcp__plugin_context7_context7__query-docs
  libraryId: "<resolved-id>"
  query: "getting started setup authentication common patterns"

以下を抽出します：

• セットアップ／インストール：利用を開始する方法
• 中核となる概念：重要な抽象概念と用語
• 一般的なパターン：典型的な使用例
• API リファレンス：必須のメソッド／関数
• 注意点：ドキュメントに記載された、わかりにくい落とし穴
• ベストプラクティス：推奨される方法

ドキュメントが長い場合は、対象を絞って複数回検索します：

1. 「インストール、セットアップ、クイックスタート」
2. 「認証、API キー、設定」
3. 「一般的なパターン、例」
4. 「エラー処理、トラブルシューティング」

3. Claude Code ガイドを参照する

スキルを作成する前に、claude-code-guide エージェントを使用して、現在のスキル規約を確認します：

Task tool with subagent_type: claude-code-guide
prompt: "What are the current conventions for writing Claude Code skills?
        I need to know: required/optional frontmatter fields,
        description best practices, and recommended structure."

これにより、生成するスキルが最新の Claude Code のパターンに沿っていることを確認できます。

4. スキルの構造を生成する

適切な場所にスキルを作成します：

• デフォルト：~/.claude/skills/<topic>/skill.md
• --project を指定する場合：.claude/skills/<topic>/skill.md

スキルのテンプレート：

---
name: <topic>
description: <What the library does>. Use when <specific triggers>. Covers: <main capabilities>.
---

# <Topic> Quick Reference

## Setup

[Installation commands and initial config]

## Core Concepts

[Key abstractions - 2-3 sentences each]

## Common Patterns

### [Pattern 1 Name]
[Code example with brief explanation]

### [Pattern 2 Name]
[Code example with brief explanation]

## API Quick Reference

| Method | Purpose | Example |
|--------|---------|---------|
| ... | ... | ... |

## Gotchas

- [Non-obvious issue 1]
- [Non-obvious issue 2]

## Links

- [Official Docs](url)
- [API Reference](url)

5. 確認して通知する

スキルを作成した後：

1. スキルが作成されたことを確認します
2. 説明（どのようなときにスキルが起動するか）を表示します
3. スキルを起動できるプロンプトの例を 2～3 個表示します

品質ガイドライン

推奨事項：

• 実用的で、すぐに活用できる情報に重点を置きます
• ドキュメントに記載された実際のコード例を含めます
• 該当する場合は、バージョン固有の情報を記録します
• 参照用に公式ドキュメントの URL を追加します

避けること：

• ドキュメント全体をコピーしない（著作権に配慮）
• マーケティングや宣伝の内容を含めない
• Claude が一般的にすでに知っている情報を追加しない
• スキルを長くしすぎない（500 行未満）

更新モード（--update）

既存のスキルを更新する場合：

1. 現在のスキルの内容を読みます
2. ドキュメントを参照して、最新情報や新しい情報を確認します
3. 既存の構造を維持しながら、新しい内容を統合します
4. 該当する場合は、バージョンの変更点を記録します

例

User: /learn stripe-payments

Claude:
1. Resolves "stripe" via Context7 → /stripe/stripe-node
2. Queries: setup, authentication, common patterns, webhooks
3. Consults claude-code-guide for current skill conventions
4. Creates ~/.claude/skills/stripe-payments/skill.md with:
   - API key setup
   - Payment intent flow
   - Webhook verification
   - Error handling patterns
5. Reports: "Created stripe-payments skill. Triggers on: 'Stripe payment', 'charge card', 'payment intent'"

要件

• Context7 MCP プラグイン（推奨）- ライブラリのドキュメントにアクセスするため
• または WebSearch／WebFetch ツール - あらゆるドキュメントを参照するための代替手段