Skip to content
cccskills
FreePublished on GitHub

instructions-audit

CLAUDE.md / AGENTS.md・skills・context・rules 等の指示ファイルの静的監査。指示ファイルの「レビューして」「監査して」「スリム化して」等の依頼時、/instructions-audit 実行時に使用。

rubric で削除候補・hook/deny 移管・skill 化/Read-when 化・description 強化・system prompt との衝突の分類ごとに指摘を修正案付きで出す。user-level と project-level 両対応。

境界: 指摘の適用や個別追記は update-inst、セッション知見の反映は update-inst の retro モード、コードの監査は codebase-review。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md5.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Instructions Audit

指示ファイル(CLAUDE.md / skills / context / rules / settings.jsonのガード設定)を ~/.claude/context/claude-customization-guide.md §7 の監査rubricで監査し、rubricの分類ごとに指摘を修正案付きで報告する。rubricの真実源は同ガイドで、本スキルには複写しない。このスキルは指摘だけを行い、修正はユーザー承認後に別途行う(read-only)。

使い方

/instructions-audit               # 自動判定(./CLAUDE.md or ./.claude があればproject、なければuser)
/instructions-audit --user        # user-level(~/.claude/)を監査
/instructions-audit --project     # project-level(./CLAUDE.md, ./.claude/)を監査
/instructions-audit <path>        # 指定ディレクトリを監査

ワークフロー

Step 1: 対象決定

引数から監査スコープを確定する。

  • 完了基準: 監査対象のルートパスと、監査対象ファイル群(CLAUDE.md / context/ / skills/ / rules/ / settings.json)のリストが確定している。user-levelの実体は ~/.claude/AGENTS.md(CLAUDE.md は互換symlink。修正提案の編集対象は実体側にする)

Step 2: インベントリ作成

対象の全指示ファイルを列挙し、規模を把握する:

  1. CLAUDE.mdと、そこから@importされるファイルを再帰的に辿る(@importは毎セッション常駐のため、常駐行数はimport先を全て合算して計算する)
  2. skills/*/SKILL.md の一覧・各行数・frontmatter(description長、allowed-tools有無)・references/の有無
  3. context/・rules/ の一覧と行数、どこから参照されているか(@import / プレーンパス / 未参照)
  4. settings.json のhooks / permissions.deny・allow
  • 完了基準: 「常駐合計行数」「skill数とdescription合計」「未参照ファイル一覧」が数値で出ている

Step 3: rubric適用(監査本体)

claude-customization-guide.md の§7 rubricと§1-6の原則を対象に適用する。

対象が合計500行を超えるなら、サブエージェントに分けて委譲する(コンテキストを守るため。分割例: CLAUDE.md+context系 / skills系)。経路は Agent tool で、subagent_type: "general-purpose"・model: "opus"(複数観点のレビュー報告)を渡す。委譲先は指摘をleadに返すだけでファイルを書かないので pane は使わない(context/herdr-delegation.md「経路の選択」)。サブエージェントへの指示に含めること:

  • 監査rubricとしてclaude-customization-guide.mdを読むこと

  • 指摘ごとに「対象ファイル:行」「rubricの分類」「根拠となる原則(§番号)」「具体的な修正案」を返すこと

  • 下記Gotchasを遵守すること

  • 完了基準: 全対象ファイルが監査済みで、各指摘に分類・根拠・修正案が揃っている

Step 4: 報告

以下の構成で報告する(ファイル生成はユーザーが求めた場合のみ):

  1. サマリ: 常駐行数・skill数・指摘件数(分類別)
  2. 指摘一覧: rubricの分類ごとに、影響の大きい順。各指摘は「対象 / 内容 / 根拠原則 / 修正案(diffまたは書き換え文)」
  3. 適用の提案: どの指摘から適用すべきかの推奨順。適用はユーザー承認後(個別の適用は /update-inst スキルを実行する)
  • 完了基準: ユーザーが各指摘にyes/noで判断できる粒度になっている

Gotchas(監査時の誤指摘防止)

  • @importは毎セッション常駐(必要時ロードではない)。常駐行数の計算はimport再帰を含める
  • allowed-toolsは事前承認であって制限ではない。「セキュリティのため制限せよ」という指摘は誤り。read-only skillへの指摘は「事前承認の欠如(permission prompt増)」として出し、実際の制限が必要な場合のみdisallowed-tools/denyを提案する
  • コミュニティ由来の数値(行数上限等)を規範として指摘しない。目安として提示し、公式原則(「消したら間違えるか」)を判断基準にする
  • 重複に見える記述が意図的な場合がある(冒頭・末尾への重要ルール再掲等)。削除提案時は意図の可能性を添える
  • 監査対象に本スキルやclaude-customization-guide.md自身が含まれる場合も除外しない

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

コードベース全体のレビュー・監査。perf/sec/test/arch/cq/docs の6観点を並列委譲し、優先度付き issue ファイルと観点サマリをメモリディレクトリに生成する。コードベース全体の監査・定期レビュー・リリース前品質確認の依頼時、/codebase-review 実行時に使用。境界: PR 単位は pr-review、自ブランチの提出前確認は self-review。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

commit

Free

変更を git-cz 形式でコミットする。リポジトリの直コミット可否の判定手順と、push 後の CI・conflict の確認を含む。/commit 実行時、「コミットして」「pushして」等の依頼時に使用。--push 引数または「pushして」の依頼で push も行う。境界: PR 作成は create-draft-pr、PR コメントへの対応コミットは pr-comment から呼ばれる。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

PR を Draft で作成する。変更をローカルで動かして確かめ、画面が変わるならスクリーンショットを gh の --attach で貼り、PR テンプレートを全セクション埋めて対象 repo の既存 PR の分量に揃え、出した後は CI・レビュー・マージを Monitor で見張る。PR 作成の依頼時、実装が一段落して PR 化する時、/create-draft-pr 実行時に使用(gh pr create を直接実行しない)。引数でベースブランチを指定できる。境界: 個別レビューコメントへの対応は pr-comment、PR 全体のレビューは pr-review、複数 PR 規模の計画は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

スキルを新規作成する。「スキルを作って」「この手順をスキル化して」等の依頼時、/create-skill 実行時に使用。AGENTS.md・context・既存スキルと整合させ、重複・競合を避ける。境界: 既存スキル・指示ファイルの修正は update-inst、指示ファイル全体の監査は instructions-audit。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

抽象的な要件・事業側の要求を深掘りし、既存実装との整合を確認して実装マスタとシステム要件書を作成する。「こういう機能を作りたい」「この要求を満たす機能を設計して」等の抽象要件の提示時、既存機能の拡張や Phase 分割の要件定義開始時、/design-feature 実行時に使用。境界: 要件確定後の実装計画書・PR 分割と実装進行は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

画面の設計判断(ナビゲーション・重ね方・通知と空状態と読み込み・外枠とトークンと状態表現)の型を決定表で選び、アプリ内の全画面で揃える。画面・ページ・レイアウト・ナビゲーション・ダイアログ・コンポーネントを新しく作る・作り直す時、モックやダッシュボードを作る時、サイドバー・タブ・モーダル・シート・toast・バナー・空状態のどれを使うか決める時に使用。PJ に components.json があれば shadcn の部品とトークンへの対応も扱う。主要なデザインシステム(Material・HIG・Carbon・Primer・Atlassian・Fluent・GOV.UK・NN/g・WAI-ARIA APG・WCAG)の一致点を規則にし、食い違いの採否を定めてある。境界: 画面の文言は writing-ui-text、画面に何を出すかと提示前の完了基準は context/ui-artifact-standards.md、コードの実装原則は writing-code、shadcn 部品の API と組み立ては shadcn。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

See all skills by ukwhatn

Report a problem with this skill