skills.rest
n0rvyn
n0rvynCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

write-feature-spec

Generate feature specs documenting implementation, design decisions, and user journeys.

1|Updated Feb 15, 2026
Search Tags:#documentation#generate#feature-spec#dev-workflow#context-recovery#agent-dispatch#decision-points
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill write-feature-spec-n0rvyn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-feature-spec
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/dev-workflow/skills/write-feature-spec
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill write-feature-spec-n0rvyn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a concise, actionable feature specification that records what was built, why design decisions were made, and which user journeys were completed so teams can regain context across sessions, prepare release notes, or hand off to reviewers.

Core Features & Use Cases

  • Dispatches a dedicated dev-workflow:feature-spec-writer agent in a fresh context to avoid bias and produce an independent spec.
  • Gathers feature identity, related design docs, dev-guide phases, and key implementation files, and handles missing design sources by prompting the user for input or alternative paths.
  • Presents a summarized spec with user-story status, detected deviations, and structured Decision Points; records user choices back into the spec file and offers follow-up actions like context restoration or external review dispatch.
  • Use case: after finishing a feature branch, generate a spec to document implementation details and decisions for release notes and independent review.

Quick Start

Write a feature spec for the current branch capturing what was built, design decisions made, and the completed user journeys.

Frequently Asked Questions about write-feature-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a feature spec used for in software development?▼

A feature spec records implemented work, design decisions, and user journeys to enable cross-session context recovery, streamline release notes, and prepare external reviews.

How do I generate a feature spec after completing a feature branch?▼

To generate a feature spec, the system dispatches an independent agent that gathers design docs, dev-guide phases, and implementation files to draft a clear specification.

How does context recovery work for incomplete development sessions?▼

Context recovery uses a generated feature spec summarizing user-story status and decision points, allowing you to restore context quickly and resume development work.

Can I document design decisions and deviations for changelog preparation?▼

Yes, the feature spec surfaces detected deviations and structured decision points, recording your choices directly into the spec file for changelog and release note preparation.

What happens if design sources are missing during feature spec generation?▼

If design sources are missing during feature spec generation, the system prompts you to provide input or specify alternative file paths to complete the documentation.

What follow-up actions are available after creating a feature spec?▼

After creating a feature spec, available follow-up actions include restoring the development context or dispatching the specification for external independent review.

Related Skills

Explore More Software Engineering Skills→
artificial-intelligence-firstartificial-intelligence-first

SKILL.md Guide (Agent Skills)

Package domain knowledge into modular units for AI agents.

Official
Advanced
zenml-iozenml-io
1

review-changelog

Reviews pending changelog entries and guides completion of missing fields.

Official
Intermediate
amitmishra-bylddamitmishra-byldd

bmad-dev-story

Execute story implementation from context-filled spec files with status transitions.

Community
Advanced
ebrahim-saniebrahim-sani

candlestick

Detect candlestick patterns and generate composite bullish or bearish signals from OHLCV data.

Community
Intermediate