spec-builder

Generate a structured spec document with problem statement, intent, and success criteria.

1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/phanijapps/zbot --skill spec-builder-phanijapps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-builder
Source: https://github.com/phanijapps/zbot/tree/main/gateway/templates/skills/spec-builder
Command: npx skills add https://github.com/phanijapps/zbot --skill spec-builder-phanijapps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill generates a structured spec for a new task, enabling planners to decompose and plan effectively.

Core Features & Use Cases

  • Generates a formal spec with Problem statement, Intent, Context summary, Suggested skills, Additional skills, Raw tools, Capability gaps, Assumptions, Success criteria, Approach, Phases, Phase dependency graph, and Pre-mortem.
  • Suitable for planning new tasks across code, research, writing, browser flows, data work, etc.
  • Use case: When planner receives a new user request, run spec-builder to produce a spec for plan-composer to execute.

Quick Start

Give the planner the verbatim user ask and any known context; spec-builder will return a formal spec document ready for plan-composer.

Frequently Asked Questions about spec-builder

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

FAQPage Schema
How do I generate a structured spec for task planning?

To generate a structured spec for task planning, provide your verbatim user ask and any known context. The spec-builder produces a formal document capturing problem definition, intent, constraints, phases, and success criteria ready for orchestration.

What is included in a task planning spec document?

A task planning spec document includes the problem statement, intent, context summary, suggested skills, assumptions, success criteria, approach, phases, phase dependency graph, and pre-mortem analysis to guide downstream execution.

When do I need to create a spec before decomposing a complex task?

You need to create a spec before decomposing a complex task when planning new work across code, research, writing, or data flows. Generating a formal spec captures constraints and capability gaps to enable effective orchestration.

Can I use this spec generation approach for research and browser flow planning?

Yes, you can use this spec generation approach for research and browser flow planning. It is suitable for planning new tasks across diverse domains including code, research, writing, browser flows, and data work.

How do I identify capability gaps and assumptions during workflow planning?

To identify capability gaps and assumptions during workflow planning, input your raw task request. The generated spec explicitly lists capability gaps, assumptions, and raw tools needed to highlight missing resources before execution.

Does the generated spec influence phase sequencing and resource needs?

Yes, the generated spec influences phase sequencing and resource needs. The output contains a phase dependency graph and pre-mortem analysis intended for plan-composer to execute and adjust sequencing accordingly.