plan-spec

Generate complete tech specifications from local plan documents to .spec/{slug}/spec.md.

9|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/mark22013333/crew --skill plan-spec-mark22013333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-spec
Source: https://github.com/mark22013333/crew/tree/main/plugins/feature-workflow/skills/plan-spec
Command: npx skills add https://github.com/mark22013333/crew --skill plan-spec-mark22013333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The current practice of generating technical specifications often relies on scattered notes and external tools, leading to inconsistency and delays. plan-spec resolves this by producing complete tech specs from local inputs and writing them to the .spec/{slug}/spec.md without calling Notion.

Core Features & Use Cases

  • Read and synthesize requirements from .spec/{slug}/README.md and related local references to generate a full specification.
  • Write the resulting spec to .spec/{slug}/spec.md to maintain a centralized, versioned artifact for engineering and product teams.
  • Support planning workflows for feature work, adjustments, and refactoring with clear scope and API design sections.

Quick Start

Run plan-spec to generate an initial tech specification from your local inputs.

Frequently Asked Questions about plan-spec

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

FAQPage Schema
How do I generate a technical specification locally without using the Notion API?

To generate a technical specification locally without Notion, you can use a tool that reads local requirements and writes structured tech specs directly to your file system. This ensures versioned artifacts without external API dependencies.

What is the best way to structure API design and business rules in engineering documentation?

Structuring API design and business rules in engineering documentation requires enforcing specific sections like scope, error handling, and decision blocks. A specification generator can synthesize local inputs to automatically format these structured sections.

How do I create a versioned tech spec from local markdown files?

Creating a versioned tech spec from local markdown files involves reading requirement documents and synthesizing them into a centralized specification. The output is written to a designated local directory to maintain consistency for engineering teams.

Do I need external API calls to produce engineering specifications for feature development?

No, you do not need external API calls to produce engineering specifications for feature development. Local specification generators operate entirely on your local machine, reading and writing files without relying on external platforms.

Can I use local markdown inputs for product management planning workflows?

Yes, you can use local markdown inputs for product management planning workflows. The process synthesizes local README files and related references to support feature work, adjustments, and refactoring with clear scope definitions.

What limitations exist when generating specifications without external tools like Notion?

Generating specifications without external tools limits real-time cloud collaboration, as artifacts are stored locally rather than synced online. However, it provides full offline control and enforces structured content without external API dependencies.