spec-author

Create and validate forgeplan SPECs with behavioral scenarios for the LIGHT pipeline.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ForgePlan/marketplace --skill spec-author-forgeplan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-author
Source: https://github.com/ForgePlan/marketplace/tree/main/plugins/fpl-skills/skills/spec-author
Command: npx skills add https://github.com/ForgePlan/marketplace --skill spec-author-forgeplan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires forgeplan, and includes scripts (resource) components.

What problem does it solve?

This Skill helps in creating clear, testable specifications (SPECs) for features or behaviors in the spec-driven LIGHT pipeline, preventing miscommunication and missed requirements during implementation.

Core Features & Use Cases

  • Spec Creation: Guides the user through creating a complete SPEC with requirements and scenarios.
  • Iterative Feedback: Provides tools for self-validation and peer review, allowing for iterative refinement.
  • Implementation Guidance: Instructs on the implementation process post-SPEC creation, ensuring the spec is followed.

Quick Start

Run the '/spec-author' command to start authoring a new SPEC.

Frequently Asked Questions about spec-author

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

FAQPage Schema
What is spec-driven specification writing for feature development?

Spec-driven specification writing creates language-neutral SPECs with behavioral scenarios that serve as the implementation oracle. This approach enforces a LIGHT pipeline methodology to prevent miscommunication and missed requirements during feature implementation.

How do I author and validate testable specifications for new features?

You author testable specifications by running the spec-author command to generate a complete SPEC with requirements and scenarios. It provides iterative feedback tools for self-validation and peer review, allowing you to refine the specification before implementation.

Do I need a specific environment to create language-neutral SPECs?

Yes, creating language-neutral SPECs requires the ForgePlan environment. The specification validation and activation process specifically depends on the forgeplan_reason, forgeplan_validate, and forgeplan_activate commands to function properly.

Can I use spec-driven design to guide my implementation process after writing a SPEC?

Yes, spec-driven design provides implementation guidance post-SPEC creation. By establishing behavioral scenarios as an implementation oracle, it ensures the development process strictly follows the validated specification and testable feature intent.

What is the best way to enforce a LIGHT pipeline approach for feature specifications?

The best way to enforce a LIGHT pipeline approach is using a guided spec-author workflow that validates behavioral scenarios iteratively. This ensures your feature intent remains testable and language-neutral throughout the specification creation process.

Why does my specification lack testable feature intent during implementation?

Your specification lacks testable feature intent if it was not validated through a spec-driven LIGHT pipeline. Without enforced behavioral scenarios acting as an implementation oracle, miscommunication and missed requirements occur during development.