ns-skill-creator

Skill Creator（harness プロジェクト）

アクティブな harness プロジェクトで、プロジェクトローカルのスキルを作成・改善します。評価ループ、説明の最適化、同梱スクリプトは上流の skill-creator（anthropics/skills）に由来します。このスキルで上書きするのは、ファイルの保存場所と、作成・更新のたびに実行する harness sync だけです。

Harness の検出

../ns-harness/references/harness-discovery.md に従ってパスを解決します。

変数	値
{product_root}	リポジトリまたはモノレポの製品フォルダー（AGENTS.md がある場所）
{skills_canonical}	{product_root}/.agents/skills/

{harness_root} がない場合は、このスキルが harness でスキャフォールドされたプロジェクトを想定していることを伝え、まず npx @nextstage-brasil/harness を実行するようユーザーに案内してください。

ステップ 0 — 上流の skill-creator を読み込む

Harness init は、anthropics の skill-creator バンドル（スクリプト、eval-viewer）を {skills_canonical}/skill-creator/ にインストールし、その後、このラッパーを ns-skill-creator としてインストールします。

上流のワークフロー全体については、次を読んでください。

• グローバルにインストールされている場合は ~/.agents/skills/skill-creator/SKILL.md、または
• anthropics/skills — skill-creator

意図の把握、ヒアリング、SKILL.md の構成、評価・ベンチマークのループ、eval-viewer/generate_review.py、説明の最適化（run_loop.py）、および {skills_canonical}/skill-creator/scripts/ 配下のスクリプトには、上流の手順を使用してください。

上流の手順に加えて、以下の パスの上書き と 作成後の同期 を適用してください。

パスの上書き（プロジェクト）

成果物	パス	備考
新規・編集するスキル	{skills_canonical}/<kebab-case-name>/	frontmatter の name はディレクトリ名と一致させます
SKILL.md	{skills_canonical}/<name>/SKILL.md	AGENTS.md でチームが別途定めていない限り、英語で記述します
references/、scripts/、evals/	スキルディレクトリ内	references/project-layout.md を参照してください
評価ワークスペース	{product_root}/skill-creator-workspace/	上流の手順に従い、iteration-N/eval-<id>/ を使用します
上流ツール	{skills_canonical}/ns-skill-creator/	anthropics バンドルの scripts/、eval-viewer/

リポジトリのルートにある skills/ にプロジェクトスキルを保存することは絶対に避けてください（この構成は nextstage-brasil/skills カタログリポジトリ専用です）。

プロジェクトの規約

草案を作成する際は references/project-layout.md を読んでください。{product_root}/AGENTS.md で言語やスキルの規約が定められている場合は、それに従ってください。

概要：

• 上流のガイダンスに従い、トリガーされやすい、積極的な説明を frontmatter に記述します。
• SKILL.md は約 500 行未満に保ち、詳細は references/ に移します。
• 評価が有効な場合は、evals/evals.json に現実的なプロンプトを 2～3 個記述します。
• スキルが他のインストール済みスキル（例：ns-harness）を参照する場合に限り、frontmatter で depends: を宣言します。

ワークフロー

上流の ns-skill-creator の各段階（意図の把握 → 草案作成 → 評価 → 改善 → 繰り返し）に従います。書き込みを行う各段階で、上記の パスの上書き を使用してください。

作成後 — ハーネスの同期

スキルファイルを書き込んだ後、または大幅に更新した後、{product_root} で次を実行します。

npx @nextstage-brasil/harness sync

これにより、Claude Code が新しいスキルを検出できるように、Claude のスキルシンボリックリンク（.claude/skills/）が再生成されます。Cursor は .agents/skills/ を直接読み込みます。

正規ルールの編集後、コミットする前に、ローカルで npx @nextstage-brasil/harness sync --check を実行し、ディスク上のアダプターが一致していることを確認します。.nextstage-harness/ の変更をコミットする前に実行してください。

同期結果をユーザーに報告します。同期待ちの間は、スキルを検出できると伝えてはいけません。

説明の最適化

スキルが安定したら、上流の ns-skill-creator（run_loop.py）に従って、説明を最適化することを提案します。アクティブなセッションのモデル ID を使用します。{skills_canonical}/<name>/SKILL.md のフロントマターを更新し、必要に応じて harness sync を実行します。