skills.rest
sandgardenhq
sandgardenhqOFFICIAL
Explore all skills by this author →
GitHub

goal-md-composer

Automate structured authoring of valid GOAL.md files for Sgai projects.

130|8|Updated Jan 23, 2026
Search Tags:#workflow#multi-agent#dag#sgai#goal.md#model assignment#review pairing
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill goal-md-composer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: goal-md-composer
Source: https://github.com/sandgardenhq/sgai/tree/main/cmd/sgai/skel/.sgai/skills/product-design/goal-md-composer
Command: npx skills add https://github.com/sandgardenhq/sgai --skill goal-md-composer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams struggle to consistently author correct, executable GOAL.md files that define multi-agent workflows, models, and success criteria. This Skill provides a structured, seven-phase wizard that ensures valid frontmatter, mandatory reviewer pairing, clear task breakdowns, and optional completion gates.

Core Features & Use Cases

  • Interactive 7-Phase Wizard: Gathers project context, recommends agents, builds a DAG flow, assigns models, and drafts the full GOAL.md specification.
  • Policy Enforcement: Automatically pairs development agents with required reviewers and prevents coordinator inclusion in the flow, ensuring a valid DAG.
  • Practical Outputs: Generates ready-to-run GOAL.md with optional completionGateScript and interactive mode, plus validation checklist and session logging to project management notes.
  • Use Case: A product owner wants a full-stack goal with Go backend and HTMX frontend; the wizard proposes developer-reviewer pairs, builds the flow into STPA analysis, assigns models, and outputs a complete GOAL.md ready for Sgai.

Quick Start

Start the GOAL.md composer to configure agents, flow, models, and tasks for a new Sgai project.

Frequently Asked Questions about goal-md-composer

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

FAQPage Schema
How do I create a GOAL.md file for a multi-agent workflow?▼

A GOAL.md file defines multi-agent workflows by specifying project context, agent selection, workflow DAG construction, and model assignment to ensure valid, executable software-generation projects.

What is the best way to set up reviewer pairing in a multi-agent DAG?▼

Reviewer pairing in a multi-agent DAG requires automatically pairing each development agent with a mandatory reviewer and excluding coordinator agents from the flow to maintain a valid directed acyclic graph.

Can I add a completion gate script and interactive mode to my GOAL.md?▼

Yes, you can configure optional completion gate scripts and interactive mode parameters when drafting the GOAL.md specification to add validation layers and control execution flow.

Does the GOAL.md wizard support assigning models to specific agents?▼

Yes, the GOAL.md wizard includes a model assignment phase where you map specific models to selected agents within the workflow DAG before finalizing the specification.

Why does my multi-agent workflow fail validation without reviewer dependencies?▼

Multi-agent workflow validation fails without reviewer dependencies because the format enforces mandatory reviewer pairing for development agents to ensure structural compliance and prevent invalid DAG configurations.

Related Skills

Explore More Software Engineering Skills→
sandgardenhqsandgardenhq
130

compose

Generate GOAL.md workflow specifications via the sgai API compose wizard.

Official
Intermediate
sandgardenhqsandgardenhq
130

session-control

Start, stop, and steer AI agent sessions in sgai workspaces.

Official
Intermediate
ucirelloucirello
2

knowledge

knowledge

Community
Basic
Habitat-ThinkingHabitat-Thinking
44

governance-constraint-design

Translate governance language into falsifiable constraints for HARNESS.md.

Official
Intermediate