ref-skill-design-rubric git:20260712.4cd8fafA

Immutable. This exact content is served forever at /api/v1/blob/d51f3bfeadd70333.

---
name: ref-skill-design-rubric
description: SKILL.mdを評価するとき、新規Skillを設計するときに読む。
disable-model-invocation: true
user-invocable: false
kind: ref
effect: none
owner: team-platform
since: 2026-05-17
# auto-backfilled by backfill-source-tier.py (doc/21)
source: doc/ClaudeCodeスキルの設計書/
source-tier: internal
last-audited: 2026-05-19
audit-trigger: quarterly
---

# ref-skill-design-rubric

## Purpose & Output Contract

Skill 設計の評価基準の **正本（upstream rubric）**。
`assign-skill-design-evaluator` は本Skillの `rubric.json` を継承して採点する。

**出力**: なし（reference）。読み手は人間 or evaluator Skill のみ。

## Key Rules

1. **本Skillが唯一の正本**: 他Skillの `rubric.json` は本ファイルを upstream とし deep-merge する（29章）。
2. **threshold 80 / max 100**: severity weights は high -20, medium -10, low -3 固定。
3. **rubric_version は semver**: minor=緩和、major=厳格化、patch=文言だけ（`run-skill-rubric-governance` 参照、27章）。
4. **改正は governance runbook 経由**: 直接編集禁止。
5. **TODO(human)を1つ残置**: BD-004 は人間の方針決定待ち。

## 評価軸サマリ

- **FM (Frontmatter)**: name kebab+prefix / description="Use when" / trigger 2-3 / 動作詳細混入なし / 動詞ベース
- **BD (Body)**: Output contract / Gotchas 節 / <=300行 / BD-004=TODO(human)
- **NM (Naming)**: ディレクトリ名一致 / 第1〜5条 / 第8〜13条
- **PD (Progressive Disclosure)**: 本文 <=100 or references/ 存在
- **RG (Governance)**: rubric_hash 埋込

各ルールの check 式と rationale は `rubric.json` を参照。

## Steps

参照用Skill。手順なし。改正手順は `run-skill-rubric-governance` を呼ぶこと。

## Gotchas

- **本Skillを直接編集しない**: `run-skill-rubric-governance` の Runbook 経由でのみ更新（27章）。
- **BD-004 を埋める前に governance を通す**: rubric変更はminor/major扱い。

## Additional Resources

- `rubric.json` — 機械可読rubric（正本）
- `references/rubric-rationale.md` — 各ルールのwhy
- 関連: `assign-skill-design-evaluator/references/rubric.json`（override層）
- 関連: `run-skill-rubric-governance/` — 改正Runbook