spec-writing

Generates and verifies build-loop-compatible plans and specifications using YAML frontmatter and Markdown content.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/tyroneross/build-loop --skill spec-writing-tyroneross
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/tyroneross/build-loop/tree/main/skills/spec-writing
Command: npx skills add https://github.com/tyroneross/build-loop --skill spec-writing-tyroneross

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of build-loop-compatible plans and specifications, ensuring that developers produce complete and high-quality documents without manual oversight.

Core Features & Use Cases

  • Automated Plan Generation: Walks through a completeness checklist and generates a structured plan for a build-loop-compatible specification.
  • Adversarial Review: Verifies the output with a deterministic checker and an adversarial critic to ensure completeness and quality.
  • Use Case: When starting a new feature development cycle, the skill can be invoked to generate a detailed plan that includes all necessary considerations and requirements.

Quick Start

To use the spec-writing skill, invoke it within the build-loop phase or manually with a specific command like "write a plan" or "spec out a feature".

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I automate specification and plan generation for build-loop workflows?

Automated plan generation for build-loop workflows uses a completeness checklist to create structured specifications. This ensures development documentation includes all necessary considerations and requirements without manual oversight.

What is adversarial review in specification writing?

Adversarial review in specification writing verifies output quality using a deterministic checker and an adversarial critic. This dual-layer verification ensures generated plans meet completeness standards before development begins.

How do I ensure completeness checks pass for feature specifications?

Completeness checks for feature specifications pass when the generated plan addresses all checklist requirements. The automated process walks through each consideration step-by-step and validates the final documentation using deterministic and adversarial review.

Do I need any dependencies to generate build-loop-compatible plans?

No dependencies are required to generate build-loop-compatible plans. The specification writing process operates standalone, requiring only YAML frontmatter for metadata and Markdown content for operational instructions.

Can I use this specification approach for new feature development cycles?

Specification generation suits new feature development cycles by producing detailed plans with all necessary considerations. Invoke it during the build-loop phase or manually with commands like 'write a plan' or 'spec out a feature'.

What format should build-loop specifications use for operational instructions?

Build-loop specifications use Markdown content for operational instructions and YAML frontmatter for metadata. This structured format ensures the generated plans are compatible with development workflows and completeness verification.