specops-orchestrate-spec-create

Orchestrate sequential subagents to generate per-file implementation specs from analysis artifacts.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-orchestrate-spec-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specops-orchestrate-spec-create
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/specops-orchestrate-spec-create
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-orchestrate-spec-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates the creation of implementation specs for multiple analysis artifacts by orchestrating sequential subagents, ensuring consistent, repeatable output without writing product code manually.

Core Features & Use Cases

  • Orchestrates per-file spec creation by delegating to sequential subagents following the specops-make-spec workflow.
  • Processes analysis files one at a time, with deterministic output paths (docs/specops/specs/<analysis-basename>.md) and verification steps.
  • Performs post-generation verification and up to two fix-up attempts per file to ensure completeness, reporting blockers as needed.
  • Supports project standards and conventions routing when present.

Quick Start

Provide a list of analysis files or a directory and let the orchestrator generate per-file specs using the specops-make-spec workflow.

Frequently Asked Questions about specops-orchestrate-spec-create

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

FAQPage Schema
How do I generate implementation specs for multiple analysis files automatically?

You can generate implementation specs for multiple analysis files by orchestrating sequential subagents that process each file individually, creating per-file specs at deterministic output paths like docs/specops/specs/<basename>.md.

What is the best way to coordinate spec creation across a repository with many analysis documents?

Coordinating spec creation across a repository is best handled by an orchestrator that delegates to sequential subagents, applying a consistent workflow to each analysis document while ensuring repeatable output without writing product code manually.

How do I verify that generated implementation specs meet required documentation sections?

Verifying generated implementation specs involves post-generation checks that confirm outputs exist and meet required sections, with up to two automated fix-up attempts per file to ensure completeness and explicit failure reporting for blockers.

Do I need a specific directory structure to orchestrate per-file spec generation?

You need a repository containing analysis documents and a deterministic output path structure where generated specs are written to docs/specops/specs/<analysis-basename>.md, ensuring the orchestrator can locate inputs and route outputs consistently.

What happens if an analysis artifact fails to generate a complete implementation spec?

If an analysis artifact fails to generate a complete implementation spec, the orchestrator performs up to two fix-up attempts per file and then reports the specific failure as a blocker, ensuring incomplete specs do not silently pass.

Can I route project standards and conventions into the spec generation workflow?

Routing project standards and conventions into the spec generation workflow is supported when those standards are present in the repository, allowing the subagents to align the per-file implementation specs with existing project conventions.