spec-file-manager

Manage specification files. Use when creating, reading, updating, or listing spec files. Triggers on requests like "create spec", "update spec", "list specs", or "show spec status".

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/spec-file-manager

SKILL.md

Spec File Manager

Manages specification files in a configurable directory.

Storage Location

Directory Detection

Search for spec directory in this order:

specs/
.specs/
docs/specs/
.dev-plans/

If none found, ask user which directory to create.

Override

Directory can be specified explicitly via command argument:

/spec:create-md docs/specifications

File Naming Convention

YYYY-MM-DD-{slug}.md

Date prefix: Creation date in ISO format (e.g., 2025-01-22)
Slug: Kebab-case, English only, max 20 characters
Extension: Always .md

Examples:

2025-01-22-user-auth.md
2025-01-22-api-pagination.md

Structure

Flat structure. No subdirectories.

Operations

Create

Detect or receive target directory
Generate filename with today's date and slug
Copy template from assets/spec-template.md
Save to target directory

List

List all .md files in spec directory sorted by date (newest first).

Update

Edit existing spec file in spec directory.

Delete

Remove spec file from spec directory.

Template

See assets/spec-template.md for the specification file template.