AgentSkillsCN

refine-skill

分析并精炼现有 Claude Code 技能,提升其简洁性与实效性。当用户要求“审查”“精炼”“改进”“优化”技能,或当用户提到“技能质量”“技能精进”,或是希望让某项技能更加精简时,可使用此技能。

SKILL.md
--- frontmatter
name: refine-skill
description: Analyze and refine existing Claude Code Skills for conciseness and effectiveness. Use when asked to "review", "refine", "improve", "optimize" Skills, or when the user mentions "skill quality", "skill refinement", or wants to make a Skill more concise.
context: fork

Skill Refinement

既存のClaude Code Skillを分析し、より簡潔で効果的なものに洗練する。

Core Principle

品質 = AIの消費しやすさ。Claude既知の情報は削除。

Workflow

  1. 読込: 全ファイル読み込み、行数・文字数測定
  2. 分析: CHECKLIST.mdと照合、問題特定
  3. 修正: 削除・追加・書き換え適用
  4. 検証: 行数減少、機能維持、トリガー明確化確認

Actions

  • 削除: 「〜とは」説明、背景説明、自明なステップ、重複
  • 追加: 具体例、トリガー、失敗対処
  • 書き換え: 曖昧→具体的、複雑→シンプル

Patterns

PatternAction
Description曖昧→具体的、トリガー追加
説明教育的散文→実行可能コード
ワークフロー10+ステップ→3-5ステップ
Progressive500行超→分割+参照

詳細例はCHECKLIST.md参照。

Quality Targets

  • Description: what + when + triggers (≤1024文字)
  • Lines: ≤500
  • References: 1階層
  • Examples: 具体的・実行可能

詳細: CHECKLIST.md

問題パターン

問題対策
過剰な説明削除
曖昧な記述具体例に置換
深い参照フラット化
冗長なワークフロー3-5ステップに統合
トリガー不足キーワード追加

Anti-Patterns

Anti-Pattern代替
教育的散文直接的な指示
無限の選択肢デフォルト + escape hatch
Windowsパス常に /
時間依存情報バージョン非依存
深い参照フラット構造