audit-skills

audit-skills

すべての src/skills/*/SKILL.md ファイルをスキャンし、OrchestKit の作成基準への準拠状況を報告します。各カテゴリのファイルは rules/ と references/ にあり、必要に応じて読み込まれます。

クイックリファレンス

カテゴリ	ファイル	影響度	使用するタイミング
監査チェック	${CLAUDE_SKILL_DIR}/rules/audit-checks.md	HIGH	スキルごとに検証する項目
ステータスルール	${CLAUDE_SKILL_DIR}/rules/audit-status.md	MEDIUM	PASS／WARN／FAIL の分類
出力形式	${CLAUDE_SKILL_DIR}/references/output-format.md	MEDIUM	テーブルのレイアウトと列の定義
エッジケース	${CLAUDE_SKILL_DIR}/references/edge-cases.md	LOW	マニフェストの「all」、オーケストレーションスキル

合計：2カテゴリにわたる2つのルール

重要：タスク管理は必須です（CC 2.1.16）

ほかのことを始める前に、進捗を追跡するタスクを作成してください：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Audit Skills: full scan",
  description="Auditing all OrchestKit skills for quality and compliance",
  activeForm="Auditing skill quality"
)

# 2. Create subtasks for each audit phase
TaskCreate(subject="Discover skills", activeForm="Globbing SKILL.md files")
TaskCreate(subject="Run audit checks", activeForm="Checking each skill")
TaskCreate(subject="Classify & render", activeForm="Classifying results and rendering report")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Before starting each task, verify it's unblocked
task = TaskGet(taskId="2")  # Verify blockedBy is empty

# 5. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

ワークフロー

1. 検出 — src/skills/*/SKILL.md を Glob して、スキルの全リストを取得します
2. 各スキルをチェック — Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md") のすべてのチェックを並列で実行します
3. 分類 — Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md") のステータスルールを適用します
4. 出力 — Read("${CLAUDE_SKILL_DIR}/references/output-format.md") の形式を使ってテーブルを出力します
5. 合計 — 最後に X pass, Y warn, Z fail を表示します

クイックスタート

bash src/skills/audit-skills/scripts/run-audit.sh

または手動で実行します。Claude が src/skills/ をスキャンし、チェックを適用して、概要テーブルを出力します。

CC 2.1.152+: 監査で見つかった SKILL.md ファイルを修正した後、/reload-skills を実行すると、スキルディレクトリを再スキャンして変更をセッション中に反映できます（再起動は不要です）。プラグインにパッケージ化されたスキルの場合は、代わりに再ビルドして /reload-plugins を実行してください。

主な判断基準

判断項目	推奨
マニフェストのチェック	ork.json の "skills": "all" は、すべてのスキルが対象になることを意味します — YES とします
ルールも参照も0件	WARN のみ — オーケストレーションスキルには、正当な理由でルールがないものもあります
壊れた参照	WARN（FAIL ではありません）— ファイルが別のパスに存在する可能性があります

関連スキル

• ork:skill-evolution — スキルを反復的に改良するためのガイダンス
• ork:quality-gates — コードベース全体の幅広い品質チェック