new-skill について
brooks-lint にスキルを追加するためのリポジトリ専用スキルです。スキルとガイドの作成、共有リソースの接続、評価シナリオの追加、テストを案内します。
主な機能
- 01スキルと番号付きガイドの作成
- 02メタデータとプロセス構成の指定
- 03関連する共有ファイルの接続
- 04正常系と誤検出の評価追加
- 05構造検証とローカルテスト
活用シーン
- 01指定された目的に沿うリポジトリスキルの作成
- 02新しいスキルの評価カバレッジ追加
- 03スキルの構造と動作のローカル確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hyhmrright/ brooks-lint --skill new-skillインストール後、Claude Code で/new-skillを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
brooks-lint — 新しいスキルのスキャフォールド
スキル名はユーザーのリクエストから取得します(ケバブケース。例:brooks-security)。空の場合は、
まず名前と1行の目的を尋ねてください。
リポジトリの「新しいスキルの追加」チェックリストに正確に従ってください。
skills/{name}/SKILL.mdを作成し、フロントマターを記述します。name、Do NOT trigger for:節で終わるdescription(リリース対象のスキルでは検証時に必須です。省略すると誤検出が発生します)、opencode/slash: "true"を含むmetadata:、ガイドのステップ範囲を本文中で示す3~6個の箇条書きからなるProcessセクションを含めます(例:リスクをスキャンする(ガイドのSteps 1–6))。skills/brooks-review/SKILL.mdなどの既存スキルの構成(Setup → Process → Mode line)に合わせます。skills/{name}/{name}-guide.mdを作成し、連番のステップを記述します。番号の飛びや重複は不可です。Step 2aのようなサブステップは使用できます。詳細な手順はガイドに記載し、SKILL.md の Process は概要の骨組みにとどめます。- フレームワークに組み込みます。 新しい SKILL.md の Setup セクションで、関連する
_shared/ファイルを読み込む必要があります(Iron Law と Report Template にはcommon.md、該当する場合はdecay-risks.md/test-decay-risks.mdも読み込みます)。_shared/は自動では読み込まれません。 evals/evals.jsonに評価テストを追加します。次の連番のidを付けて、少なくともハッピーパスのシナリオを1つ(関連するリスクコードをexpected_outputに含める)、誤検出のシナリオを1つ(no_risk_codes: trueを指定)追加します。各シナリオにはid、name、prompt、expected_output、mode、filesが必要です。- 検証します。
npm run validate(構造、ステップの連続性、Process セクションの有無)とnpm run evals(評価スキーマ)を実行します。両方が通るまで修正します。 - ローカルでテストします。 新しいスキルのフォルダーを
skills/から.agents/skills/にリンクし、_sharedのシンボリックリンクと並べます。次に、Codex セッションで$<skill-name>を使って呼び出し、Iron Law の出力を確認します。
Codex はリポジトリのスキルを直接検出するため、コマンドラッパーは不要です。 作成したファイルと、validate/evals の結果を報告してください。
コメント
Markdown 対応