spec-generator

What This Skill Does

The Spec Generator is a specialized documentation engine designed for OpenClaw AI agents to produce structured, professional-grade technical specifications. It enforces a rigorous but flexible workflow for increment planning using the SpecWeave methodology. By automatically generating standard templates like spec.md, plan.md, and tasks.md, it ensures that your project documentation remains consistent, actionable, and ready for development. The skill is deeply context-aware, requiring agents to parse existing project structures and configurations before outputting any files, which prevents the creation of orphaned tasks or improperly categorized documentation.

Installation

To install this skill, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/anton-abyzov/sw-spec-generator Once installed, the skill will integrate into your agent's capability set, allowing it to interpret requests for architectural planning or feature definition using its built-in internal templates.

Use Cases

• Feature Lifecycle Management: Transform high-level product ideas into detailed user stories with granular acceptance criteria.
• Refactoring Documentation: Clearly define current states, proposed architectural changes, and migration strategies to minimize technical debt.
• Bug Resolution: Create standardized incident reports that link specific problems to root causes and verified testing procedures.
• Team Alignment: Ensure all team members have access to a single source of truth for upcoming increments, complete with embedded task lists.

Example Prompts

1. "We need to implement OAuth2 authentication for our API. Use the spec-generator to create a spec.md, plan.md, and tasks.md based on our security requirements."
2. "Generate an increment specification for a bug fix involving the race condition in the data synchronization engine. Make sure to include a root cause analysis."
3. "Start an increment planning session for the 'Dark Mode' feature. I need the full SpecWeave package with user stories assigned to the 'UI-Core' project."

Tips & Limitations

Always ensure the agent has read access to your .specweave directory. The most critical aspect of using this skill is the mandatory 'Project' field. If the agent fails to find a project context, manually provide the project name or ID. Remember that this tool is designed for structured outputs; it performs best when given a clear summary of the intended scope before generation begins. Avoid using this skill for free-form creative writing; it is strictly meant for technical requirement gathering and project management increments.