Skip to content
cccskills
FreePublished on GitHub

ref-claude-code-skill-spec

frontmatterを記述するとき、subagent/hooksを配線するときに読む。

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

See how to install

Files included (6)

  • SKILL.md3.3 KB
  • prompts/R1-search-summarize.md6.8 KB
  • references/frontmatter-fields.md2.1 KB
  • references/lifecycle.md1.5 KB
  • references/resource-map.yaml723 B
  • references/subagent-and-hook.md1.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ref-claude-code-skill-spec

Purpose & Output Contract

Claude Code Skills の仕様サマリ。 公式仕様と {{PROJECT_ROOT}} ローカル規約を区別し、frontmatter・ライフサイクル・Subagent/hook 連携の判断材料を圧縮する。

Key Rules

  1. 公式とローカル規約を区別: 公式上は description 推奨中心。{{PROJECT_ROOT}} 出荷基準では name, description を必須として lint する。
  2. disable-model-invocation: true で自動発動を抑止(ref系)。
  3. user-invocable: false でユーザー直接呼出抑止(assign系)。
  4. allowed-tools は最小権限。Bash(python3 *) のように glob 制限可能。
  5. context: fork で 新規 context(evaluator用、09章)。
  6. pair で対になるSkill宣言(generator↔evaluator)。
  7. frontmatter は YAML 1.2: タブ禁止、true/false小文字。

frontmatter フィールド表(要約)

field区分用途
namelocal requiredディレクトリ名と一致
descriptionofficial recommended / local required発動条件 exactly 2 trigger
disable-model-invocationofficial自動発動抑止
user-invocableofficialユーザー直接呼出抑止
allowed-toolsofficialtool 承認省略
argument-hint / argumentsofficialrun系の引数
contextofficialfork / inline
agentofficialsubagent種別
pairlocal対Skill
kindlocalrun/ref/assign/wrap/delegate
rubric_refs / reference_refs / script_refslocal多重継承(29章)
merge_strategy / conflict_policylocaldeep-merge / most-specific-wins
aliaseslocal改名時の旧名

詳細は references/frontmatter-fields.md。

ライフサイクル

  1. trigger一致 → 2. frontmatter読込 → 3. SKILL.md本文展開 → 4. references/scripts 必要時ロード → 5. tool実行 → 6. compaction時に保持/捨象判定。

詳細は references/lifecycle.md。

Steps

参照用。frontmatter 書く時は本文の表を見て、不足時に references/frontmatter-fields.md へ。

Gotchas

  • disable-model-invocation: true + user-invocable: true は意味的に矛盾しないが直感に反する: ref系を CLI から直接読ませる構成。
  • context: fork を付け忘れると evaluator が本体contextを汚染(Goodhart)。
  • allowed-tools で Bash(*) は危険: 必ず glob 制限。
  • trigger は exactly 2: 03章 hard rule。1個は鍵不足、3個以上は description 肥大化。

Additional Resources

  • references/frontmatter-fields.md — 全フィールド詳細表
  • references/lifecycle.md — 発動・compaction・hook
  • references/subagent-and-hook.md — Subagent / Agent Teams / hooks(17章)

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

アプリ・Webサービス・業務ツールの制作を、証拠分析→確定的な初稿→要件定義→体験設計→機能分解→実装→品質ゲート→リリース判定の手順ゲート制で進めるスキル。質問で要件を埋めるのではなく、依頼文・既存コード・資料・ログから最有力案を選び、動く成果物を先に出して差分で改善する。ユーザーが「アプリを作りたい」「ツールを作って」「〜を自動化したい」「システム化したい」「要件定義」「仕様を決めたい」「UI/UXを設計して」「体験を良くしたい」「機能を洗い出して」「MVPを決めたい」「品質チェック」「リリースしていいか判断して」などと言ったら必ず使用する。外部データの取込・マスタ・締め処理を伴う業務システムでは references/data-lifecycle.md も併用する。新規・既存を問わずアプリの制作・改善・リニューアルで使用する。

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

daishiman/harness-dev10Updated Oct 19, 2026

Webアプリの準備→要件定義→設計→実装→公開→品質ゲートを実行する内部オーケストレーター。Claude Codeの /build-app /improve-app、Codexの $build-app / $improve-app から明示的に委譲された場合、custom agent起動時、または利用者が $app-orchestrator を明示した場合だけ使用する。一般のアプリ相談から暗黙起動しない。

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

daishiman/harness-dev10Updated Oct 19, 2026

run-extract-blueprint が生成した章別ブループリントの忠実性を独立 context で評価したいとき、事実/推測区別と粒度と被覆を検証し draft_hash に束縛した PASS/FAIL verdict をローカル品質ゲート (C01 の周回内の受入判定・差し戻し) へ渡したいときに使う。

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

daishiman/harness-dev10Updated Oct 19, 2026

確認点で利用者が見る深さを選んだあと打ち合わせ資料を作り手とは別の目で確かめたいとき、正確さ・言葉・見た目・シンプルさの指摘を資料の編集なしで受け取りたいときに使う。

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

daishiman/harness-dev10Updated Oct 19, 2026

生成した handout 資料が初心者に伝わるか読みやすさレビューを依頼したいとき、独立 context のレビュアーから指摘と根拠つきの verdict を回収したいときに使う。

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

daishiman/harness-dev10Updated Oct 19, 2026

Notion ページを描画する直前に粒度を検証したいとき、info-collector-agent ページと同等の section 充足度を section_canonical_map 基準で機械検証したいときに使う。

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

daishiman/harness-dev10Updated Oct 19, 2026

See all skills by daishiman

Report a problem with this skill