Analyze and refine existing Claude Code Skills for conciseness and effectiveness. Use when asked to "review", "refine", "improve", or "optimize" Skills, or when the user mentions "skill quality" or "skill refinement", or wants to make a Skill more concise.
既存のClaude Code Skillを分析し、より簡潔で効果的なものに洗練する。
品質 = AIの消費しやすさ。Claude既知の情報は削除。
| Pattern | Action | | ------------ | ------------------------- | | Description | 曖昧→具体的、トリガー追加 | | 説明 | 教育的散文→実行可能コード | | ワークフロー | 10+ステップ→3-5ステップ | | Progressive | 500行超→分割+参照 |
詳細例はCHECKLIST.md参照。
詳細: CHECKLIST.md
description は [What it does] + [When to use it] + [Key capabilities] の公式に従う。
# Good — 具体的な what/when/triggers
description: Extract text from PDFs, fill forms, merge documents. Use when working with PDF files or when user mentions "PDF", "forms", "document extraction".
# Bad — 曖昧、トリガーなし
description: Helps with documents.
# Bad — 技術的すぎ、ユーザー視点なし
description: Implements the Project entity model with hierarchical relationships.
negative trigger で over-triggering を防ぐ:
description: ...Use for statistical modeling, regression. Do NOT use for simple data exploration (use data-viz skill instead).
| Symptom | Cause | Fix |
| ---------------------------- | ------------------------------------- | ---------------------------------------------------------- |
| スキルがロードされない | description が曖昧/トリガー不足 | trigger phrases 追加、ユーザーが言いそうなフレーズを含める |
| 無関係なクエリでロードされる | スコープが広すぎる | negative trigger 追加、対象を限定 |
| 指示が無視される | instructions が冗長/埋もれている/曖昧 | 重要指示をトップに、箇条書き化、詳細は references/ へ |
| 出力品質が低い | model laziness | ## Performance Notes で明示的に品質要求 |
| 過剰な説明 | Claude既知の情報を記載 | 「〜とは」説明・背景・自明なステップを削除 |
| 深い参照チェーン | A→B→C の多段参照 | 1階層にフラット化 |
Before:
description: Creates sophisticated multi-page documentation systems.
問題: What はあるが When/Triggers がない。「sophisticated」は無意味。
After:
description: Generate multi-page documentation from source code. Use when user says "generate docs", "API documentation", or uploads code files for documentation.
Symptom: スキルはロードされるが指示通りに動かない。
診断チェック:
## Critical でトップに移動## Performance Notes セクションで品質明示Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer