feature-spec-creator

Creates self-contained implementation specifications for GitHub issues and feature requests.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/urban233/ntn-ingest --skill feature-spec-creator-urban233
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: feature-spec-creator
Source: https://github.com/urban233/ntn-ingest/tree/main/.agents/skills/feature-spec-creator
Command: npx skills add https://github.com/urban233/ntn-ingest --skill feature-spec-creator-urban233

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a GitHub issue or a rough feature idea into a spec that a junior developer or coding agent can execute without follow-up questions is slow and error-prone. This Skill guides the conversation through elicitation, codebase grounding, approach approval, and decision interrogation, then produces a complete implementation spec. ## Core Features & Use Cases - Dual entry points: Start from an existing GitHub issue (with optional shared-contracts ledger) or from a fresh feature request, without re-asking questions already answered in the conversation. - Structured five-phase workflow: Elicitation, codebase grounding, minimal-approach proposal with explicit user approval, one-question-at-a-time decision interrogation, and spec drafting from a canonical template. - Quality-gated output: The spec must name exact files, include code snippets or pseudocode, cover happy-path and edge-case tests, state non-goals, and reference shared-contract anchors by name. - Use Case: A user pastes a GitHub issue body and asks "what should we do with this?" The Skill loads the issue's scope and acceptance criteria, grounds the approach in the codebase, resolves open implementation decisions, and writes a ready-to-implement spec to specs/<issue-slug>-impl-spec.md. ## Quick Start Paste a GitHub issue or describe a feature and ask the assistant to write an implementation spec for it.

Frequently Asked Questions about feature-spec-creator

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

FAQPage Schema
How do I turn a GitHub issue into an implementation spec?▼

Paste the GitHub issue body into the conversation and ask for a spec. The Skill reads the issue's scope, non-goals, acceptance criteria, and open questions, then grounds the approach in your codebase and drafts a complete spec without re-asking answered questions.

How to write a feature specification a junior developer can implement?▼

Follow the Skill's five-phase workflow: elicit requirements, ground in the codebase, get the minimal approach approved, interrogate open decisions one at a time, then draft using the spec template. The output names exact files, includes code snippets, and covers edge-case testing.

Does the spec workflow require a shared-contracts ledger?▼

No, the ledger is optional. If one exists from a blueprint-to-issues run, the Skill loads it and treats its anchors as fixed inputs; otherwise it marks the feature as standalone and lists informal conventions instead.

When should I not use a full implementation spec?▼

Skip the full spec for trivial changes, typo fixes, or exploratory spikes where requirements are still unstable. The workflow is designed for features with defined scope that need to be executed correctly by someone without prior context.

Where is the generated implementation spec saved?▼

Specs are saved to specs/<issue-slug>-impl-spec.md by default, or to any path you specify. The file follows the canonical template in references/spec-template.md with twelve sections from overview through definition of done.