create-spec

Generate a phase-based implementation spec with tasks and dependencies.

2|Updated Aug 1, 2024
One-click install
npx skills add https://github.com/Kabilan108/dotfiles --skill create-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-spec
Source: https://github.com/Kabilan108/dotfiles/tree/main/agents/skills/create-spec
Command: npx skills add https://github.com/Kabilan108/dotfiles --skill create-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill converts vague project ideas into a concrete, phased specification that guides planning, discussion, and implementation, reducing ambiguity and back-and-forth.

Core Features & Use Cases

  • Phase-based spec: outputs an actionable plan with Explore, Discuss, and Write phases.
  • Template-driven output: uses references/spec-template.md to structure the spec, ensuring consistency.
  • Phase deliverables and branching: includes concrete tasks, dependencies, and a suggested branch name for each phase.
  • Use Case: starting a new feature in a monorepo or a greenfield project by generating a ready-to-refine spec for spec-interview or spec-driven-build.

Quick Start

Provide a project idea or description to the create-spec skill. It will generate a spec file (<project-name>/spec.md) using the references/spec-template.md as the guide.

Frequently Asked Questions about create-spec

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

FAQPage Schema
How do I turn a rough software project idea into an actionable specification?

To turn a rough idea into an actionable specification, provide your project description to generate a structured spec. The output uses a template to define concrete tasks, dependencies, and branch-name suggestions across Explore, Discuss, and Write phases.

What is a phase-based specification for new feature planning?

A phase-based specification is a structured implementation plan that guides project development through Explore, Discuss, and Write stages. It reduces ambiguity by outlining concrete tasks and dependencies for each phase, ensuring clear planning and build execution.

How do I structure implementation specs for early-stage greenfield projects?

Structure implementation specs for early-stage projects by using a template-driven output to organize tasks and dependencies. This generates a ready-to-refine spec file that breaks down the work into Explore, Discuss, and Write phases for clear execution.

Can I use a generated spec file for spec-interview and spec-driven-build workflows?

Yes, generated spec files are designed to be ready-to-refine inputs for spec-interview or spec-driven-build workflows. The template-driven output creates a structured plan that directly supports downstream planning and discussion processes.

What is the best way to plan dependencies and branch names for a new feature?

The best way to plan dependencies and branch names is to generate a phase-based spec from your project idea. This process automatically suggests a branch name and lists concrete dependencies for each stage of the implementation plan.

When should I avoid using a template-driven spec for software planning?

You should avoid using a template-driven spec when your project requires highly non-linear or exploratory workflows that cannot be structured into predefined Explore, Discuss, and Write phases. It is best suited for structured early-stage ideas and feature work.