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.