Menü
Claudeの能力を拡張する新規/既存スキルの設計・更新に使うガイド。専門知識、ワークフロー、ツール連携を備えたSkillを作るときに使用する。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
1Password CLI (op) でサインイン・vault 確認・secret 注入を行う時に使う。Claude セッションでは service account token (OP_SERVICE_ACCOUNT_TOKEN) をtoken ファイル (~/.config/op/service-account-token) から直前注入する方式を使い、op read の stdout を Claude context に流さない方針を強制する。「op signin」「op service-account」「op read」「op run」「op inject」「1Password から取って」などで発火。
Browser automation for opening sites, forms, clicks, screenshots, scraping, login, and web app testing.
Run browser automation on AWS Bedrock AgentCore cloud browsers or AWS-hosted sessions.
Capture architecture decisions as ADRs with context, alternatives, and rationale.
不具合修正のワークフロー（調査→再現→修正→検証）を controller がオーケストレーションするための指揮書。バグ・不具合・障害の修正で使う。explorer で原因特定、implementer で再現テスト→修正、verifier で検証。「バグを直して」「不具合修正」「この障害を調査して直す」などで参照。
Create CodeTour `.tour` walkthroughs with file/line anchors.
| name | skill-creator |
| description | Claudeの能力を拡張する新規/既存スキルの設計・更新に使うガイド。専門知識、ワークフロー、ツール連携を備えたSkillを作るときに使用する。 |
| license | Complete terms in LICENSE.txt |
このスキルは、効果的なSkillを設計・作成するための実践ガイドである。
Skillは、Claudeの能力を拡張するためのモジュール式の自己完結パッケージである。特定領域の知識、手順、ツールを束ねることで、汎用エージェントを専門エージェントへと変換する。
コンテキストウィンドウは共有資源である。Skillは、システムプロンプト、会話履歴、他Skillのメタデータ、ユーザー要望と同じ窓を分け合う。
前提: Claudeは十分に賢い。 Claudeが既に知っていることは書かない。各情報について「本当に必要か」「トークンコストに見合うか」を常に検討する。
長い説明より短い例を優先する。
タスクの壊れやすさとばらつきに合わせて、指示の厳密度を調整する。
自由度 高 (テキスト指示): 複数の手段が妥当で、状況依存の判断が必要な場合。
自由度 中 (疑似コード/パラメータ付きスクリプト): 推奨パターンがあり、ある程度の変化が許容される場合。
自由度 低 (具体的手順/少数のパラメータ): 失敗コストが高く、厳密な手順が必要な場合。
狭い橋にはガードレールが必要で、広い野原では自由に歩けるという比喩を意識する。
各Skillは必須のSKILL.mdと任意の同梱リソースで構成される。
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter metadata (required)
│ │ ├── name: (required)
│ │ └── description: (required)
│ └── Markdown instructions (required)
└── Bundled Resources (optional)
├── scripts/ - Executable code (Python/Bash/etc.)
├── references/ - Documentation intended to be loaded into context as needed
└── assets/ - Files used in output (templates, icons, fonts, etc.)
SKILL.mdは以下で構成される。
name と description を含む。これらだけがSkillの発火判定に使われるため、用途と利用条件を明確に書く。scripts/)決定論的な信頼性が必要な処理や、繰り返し書くコードを格納する。
scripts/rotate_pdf.pyreferences/)必要に応じて読み込むべきドキュメントや参考資料を置く。
references/finance.md、references/mnda.md、references/policies.md、references/api_docs.mdassets/)コンテキストに載せず、出力に使うためのファイルを置く。
assets/logo.png、assets/slides.pptx、assets/frontend-template/、assets/font.ttfSkillは機能に直結する必須ファイルのみ含める。以下のような付随ドキュメントは作らない。
SkillはAIエージェントが仕事をするための情報だけに絞る。作成経緯、セットアップ手順、ユーザー向け解説などの付随情報は不要である。
Skillは3段階の読み込みでコンテキストを節約する。
SKILL.md本文は必要最小限に保ち、500行以内を目安にする。長くなる場合は分割し、どのタイミングで読むべきかをSKILL.mdで明示する。
基本原則: 複数のバリエーションやフレームワークに対応する場合、SKILL.mdには基幹手順と選択指針だけを書く。詳細は参照ファイルへ分ける。
Pattern 1: High-level guide with references
# PDF Processing
## Quick start
Extract text with pdfplumber:
[code example]
## Advanced features
- **Form filling**: See [FORMS.md](FORMS.md) for complete guide
- **API reference**: See [REFERENCE.md](REFERENCE.md) for all methods
- **Examples**: See [EXAMPLES.md](EXAMPLES.md) for common patterns
Claudeは必要な時だけFORMS.mdやREFERENCE.mdを読む。
Pattern 2: Domain-specific organization
複数ドメインがある場合は、ドメイン別に分けて不要な読み込みを避ける。
bigquery-skill/
├── SKILL.md (overview and navigation)
└── reference/
├── finance.md (revenue, billing metrics)
├── sales.md (opportunities, pipeline)
├── product.md (API usage, features)
└── marketing.md (campaigns, attribution)
ユーザーがsalesの質問をしたときだけsales.mdを読む。
同様に、複数クラウドや実装差分がある場合は、バリアント別に分ける。
cloud-deploy/
├── SKILL.md (workflow + provider selection)
└── references/
├── aws.md (AWS deployment patterns)
├── gcp.md (GCP deployment patterns)
└── azure.md (Azure deployment patterns)
Pattern 3: Conditional details
基本内容だけ示し、条件付きで詳細へ誘導する。
# DOCX Processing
## Creating documents
Use docx-js for new documents. See [DOCX-JS.md](DOCX-JS.md).
## Editing documents
For simple edits, modify the XML directly.
**For tracked changes**: See [REDLINING.md](REDLINING.md)
**For OOXML details**: See [OOXML.md](OOXML.md)
Important guidelines:
以下の順で進める。
理由がない限り順番通りに進める。
利用パターンが十分に明確な場合のみ省略可能。既存Skillの改善でも有効。
有効なSkillを作るには、実際にどう使われるかの具体例を把握する。ユーザーの例を聞くか、仮の例を提示して確認を得る。
例: image-editor Skillの場合の質問例
一度に質問を詰め込みすぎない。まず重要な質問から始め、必要に応じて追加する。
このステップは、Skillが担う範囲が明確になった時点で完了とする。
具体例を次の観点で分析する。
例: pdf-editor Skillの場合
scripts/rotate_pdf.py を用意する例: frontend-webapp-builder Skillの場合
assets/hello-world/ にテンプレートを置く例: big-query Skillの場合
references/schema.md を用意する各例から再利用素材を抽出し、必要なファイル一覧を作る。
新規Skillを作る場合は必ず init_skill.py を実行する。既存Skillの改善のみなら省略可能。
scripts/init_skill.py <skill-name> --path <output-directory>
このスクリプトは以下を自動生成する。
scripts/ references/ assets/ の例ディレクトリ初期化後に不要な例ファイルは削除し、必要な内容に置き換える。
Skillは別のClaudeが使う前提で設計する。Claudeが知らない手順やドメイン知識、再利用可能な資産を明確に書く。
設計で定めた scripts/ references/ assets/ を先に整備する。必要ならユーザーから資料を受け取る。
追加したスクリプトは実際に実行して検証する。類似スクリプトが多数ある場合は代表的なものを試験し、全体の信頼性を担保する。
初期化で生成された不要な例ファイルは削除する。
記述ルール: 必ず命令形/不定詞形で書く。
name と description のみを書く。
name: Skill名description: Skillの主要トリガー。何をするSkillか、どの文脈で使うかを具体的に書く。
docx SkillのdescriptionDo not include any other fields in YAML frontmatter.
Skillの使い方と同梱リソースの扱い方を説明する。
完成したSkillは配布用の .skill にパッケージする。パッケージ前に自動バリデーションが走る。
scripts/package_skill.py <path/to/skill-folder>
出力先指定:
scripts/package_skill.py <path/to/skill-folder> ./dist
パッケージスクリプトは以下を行う。
Validate (自動検証)
Package (生成)
my-skill.skill のような名称でSkillを作成.skill はzip形式で、必要ファイルを全て含む検証に失敗した場合はエラーを修正して再実行する。
Skillは実利用から改善されることが多い。使った直後が最も改善点を見つけやすい。
Iteration workflow: