# Spec Create

> Create a new numbered spec file from the template with auto-incremented SPEC-NNN numbering

- Skill: `majiayu000/spec-create-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/spec-create-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/spec-create-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/spec-create-2

---


You are creating a new spec file for the AgentForge project using auto-incremented numbering.

Follow these steps:

**Step 1: Find the current highest spec number**

List `specs/active/` sorted, and find files matching `SPEC-NNN-*.md`. Identify the highest NNN. If none exist, start at SPEC-001.

**Step 2: Determine the new spec number**

Increment the highest found number by 1 (e.g., if SPEC-024 is highest, the new spec is SPEC-025). Zero-pad to 3 digits.

**Step 3: Get the spec title**

If the user provided a title as an argument, use it. Otherwise ask:
> "What is the title for this new spec?"

Convert the title to kebab-case for the filename (e.g., "API Key Rotation" → `api-key-rotation`).

**Step 4: Copy the template**

Copy `specs/template.md` to:
```
specs/active/SPEC-NNN-<kebab-case-title>.md
```

**Step 5: Fill in the template header**

In the new spec file, replace:
- The spec number placeholder → `SPEC-NNN`
- The title placeholder → the actual title
- Both date fields → today's date (YYYY-MM-DD)

Leave all other sections for the user to fill in.

**Step 6: Report**

Tell the user:
- The path of the new spec file
- The spec number assigned
- Which sections to fill in next (Overview, Problem Statement, Goals, Proposed Solution)
- Reminder: per CLAUDE.md Rule 2 (SpecSafe-First), write tests before implementing