Smithery is now a part of Arcade.dev! Read more in our announcement here
Analyze and refine existing Claude Code Skills for conciseness and effectiveness...
既存の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 セクションで品質明示