Feature Spec

既存プロダクトへの機能追加の仕様を対話で固め、既存コード・既存仕様との整合を調査して REQ-# 契約付きの docs/dev/<対象>/spec.md を作成・改訂するスキル。/feature-spec <対象名> で明示的に呼び出されたときのみ使用する。

9 starsWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add yasunori0418/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add yasunori0418/skills --skill feature-spec
Manual install
git clone --depth 1 https://github.com/yasunori0418/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/product/feature-spec ~/.claude/skills/feature-spec

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# feature-spec: 機能追加の仕様作成・改訂

既存プロダクトへ機能を足すときの **仕様書 1 本** を作る単機能スキル。成果物は
`docs/dev/<対象>/spec.md` で、全機能要求に一意 ID(`REQ-#`)を付ける。この ID は
下流のテスト工程・設計工程・レビュー工程が参照する **トレーサビリティ鎖の上流起点** になる。

## product-spec との住み分け

| | product-spec | feature-spec(本スキル) |
| --- | --- | --- |
| 対象 | 新規プロダクトの立ち上げ | 既存プロダクトへの機能追加 |
| 調査の軸 | 競合・類似プロダクト調査(市場に何があるか) | **既存コード・既存仕様との整合調査**(自分たちの中に何があるか) |
| 成果物 | 軽量ワンページの仕様ドラフト | `REQ-#` 契約を持つ `spec.md` |
| ID 契約 | なし | あり(`REQ-#` / `AC-#`) |

新規プロダクトのコンセプト固めなら `/product-spec` を使う。本スキルは
「動いているプロダクトがあり、そこへ機能を足す」場面専用で、競合調査の枠を
**既存資産との整合調査** に置き換えている。

## このスキルがやらないこと

- **実装しない**。コードの作成・修正はこのスキルの範囲外。
- **基本設計を書かない**。モジュール構成・インターフェース・データフローは `/basic-design`
  の領分。仕様は「何を満たすか」まで、設計は「どう実現するか」。
- **テスト成果物を作らない・直さない**。`docs/test/<対象>/` 配下は testing スキル群の担当。
  改訂モードでテスト成果物の改善提案を **読む** ことはあるが、その提案の削除・更新はしない
  (testing 側の横断原則が担う)。
- **意味の検証を機械検査に委ねない**。曖昧語の排除・記述品質は本スキルの責務(後述)。

## このスキルが従う原則

### 1. 単体動作(graceful degradation)

- 成果物の既定パスは **`docs/dev/<対象>/spec.md`**。`<対象>` は機能を表す kebab-case の
  短い名前(英数字・ハイフンへ正規化)。
- **プロジェクト側(`CLAUDE.md` / `AGENTS.md` 等)に成果物の配置規約があればそちらを優先する**。
- 任意入力(あれば精度が上がるが、無くても成立する):
  - `docs/dev/definition-of-done.md`(完成の定義。受け入れ条件の粒度合わせに使う)
  - `docs/test/<対象>/` 配下のテスト成果物(改訂モードの改善提案の収集元)
  - 任意のレビュードキュメント・ユーザーの直接指示
- 任意入力が無いことを理由に中断しない。無い入力は「無い」と明示して先へ進む。

### 2. 調査優先 + 決定のみ質問

- **事実はリポジトリ調査で埋める**。既存の実装・規約・命名・依存関係は、利用者に訊く前に
  自分で調べる。
- **利用者にしか決められない判断だけ** を `AskUserQuestion`(推奨案を先頭)で確認する。
  本スキルでは **スコープの線引き・要求の取捨選択・優先度・改訂提案の採否** がこれに当たる。
Read the full skill on GitHub

Details

Skill name
feature-spec
Path
skills/product/feature-spec/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Feature Spec skill do?

既存プロダクトへの機能追加の仕様を対話で固め、既存コード・既存仕様との整合を調査して REQ-# 契約付きの docs/dev/<対象>/spec.md を作成・改訂するスキル。/feature-spec <対象名> で明示的に呼び出されたときのみ使用する。

How do I install the Feature Spec skill?

Claude Code plugin: /plugin marketplace add yasunori0418/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Feature Spec popular?

It lives in yasunori0418/skills, which has 9 GitHub stars and 0 forks.

Related skills

Agent Teams

9

yasunori0418/skills

Claude Code の並列エージェント(agent teams・teammate)の後始末と無応答時の打ち切りルール。`name` を付けて Agent を起動するとき、TeamCreate でチームを組むとき、teammate から `idle_notification` が届いたとき、評価ループ等で次のイテレーションのエージェントを起動する前、エージェントの返信が届かないときに参照する。`name` を付けない通常のサブエージェント起動だけなら対象外。

AI, LLMs & Agents

Basic Design

9

yasunori0418/skills

spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。

Writing & Content

Biz Translate

9

yasunori0418/skills

技術的な内容を、技術用語を排したビジネス職向けの平易な説明文に翻訳する。`/biz-translate` と明示的に呼ばれたときのみ実行する。

Writing & Content

Technical Editor

5

cellrishi-code/claude-skills-atlas

Use when editing technical writing for clarity, structure, precision, grammar, and consistent terminology while preserving the author's meaning.

Writing & Content

External Writes

9

yasunori0418/skills

Notion・Slack・GitHub Issue/PR・Linear等の外部システムへの書き込み・更新・コメント操作時の運用ルール。MCP書き込み系操作、Notion転記、Slack投稿、Issue/PRコメント、Linearチケット更新等を実行するときに必ず参照する。URLが会話に登場しても自動更新しないという原則を含む。

Writing & Content

Alapi

9

wangyendt/wayne-skills

Comprehensive ALAPI skill covering the full bundled ALAPI OpenAPI catalog. Use when the user mentions ALAPI, alapi, ALAPI_TOKEN, openapi.json, or an ALAPI path like /api/..., or asks to find which ALAPI API matches a business need, choose between similar ALAPI endpoints, explain request fields, prepare or execute a request, or troubleshoot an ALAPI response. Covers inspirational content, articles, news and hotlists, AI chat/translation/NLP, OCR and document recognition, weather and calendar data, IP/phone/ID/domain/ICP/enterprise lookup and verification, finance/exchange/gold/oil/crypto market

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.