spec-generate

Generates plugin specification and scaffolding files from planning artifacts.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/Ameng2001/astra-studio-plugins --skill spec-generate-ameng2001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-generate
Source: https://github.com/Ameng2001/astra-studio-plugins/tree/main/studio-planner/skills/spec-generate
Command: npx skills add https://github.com/Ameng2001/astra-studio-plugins --skill spec-generate-ameng2001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the repetitive manual work of turning planning artifacts into a complete, build-ready plugin workspace by generating the required specification and scaffolding files automatically.

Core Features & Use Cases

  • Spec workspace generation: Creates brief.md, plugin.json.draft, and SKILL.md skeletons directly from studio/changes/*/ planning outputs.
  • Build-ready implementation scaffolding: Writes implementation-structure files into the target plugin directory, including skills/*/SKILL.md and commands/*.md for user-invocable skills.
  • Trait-driven extras: Optionally generates runtime workspace scaffolding, approval-gate sections for HIL-gated skills, and pipeline orchestration commands based on traits detected in the skill map.

Quick Start

Use the spec-generate step after your skill-design is ready to automatically produce the plugin specifications and command scaffolding for the build stage.

Frequently Asked Questions about spec-generate

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

FAQPage Schema
How do I generate plugin spec files from existing planning artifacts?

To generate plugin spec files, you read existing planning artifacts like skill-map.md and status.json, then use template rendering to automatically emit brief.md, plugin.json.draft, and SKILL.md skeletons into your target plugin workspace.

What is trait-driven build scaffolding for plugin workspaces?

Trait-driven build scaffolding detects specific traits in your skill map to conditionally generate runtime workspace files, approval-gate sections for human-in-the-loop gating, and pipeline orchestration commands alongside standard spec files.

How do I scaffold build-ready skills and commands without interactive brainstorming?

You scaffold build-ready skills deterministically by processing existing skill maps and status files to output SKILL.md and commands/*.md files, bypassing interactive brainstorming to directly produce implementation structure for the build stage.

Can I use markdown and yaml planning files to automate command generation?

Yes, you can use markdown and yaml planning files as input to automate command generation, reading studio workspace artifacts to render and write user-invocable command files into the target plugin directory.

What workspace automation outputs should I expect from plugin spec generation?

Plugin spec generation outputs include brief.md, plugin.json.draft, skills/*/SKILL.md, commands/*.md, and an updated status.json file reflecting building-ready draft skills within your studio changes directory.