skills.rest
britt
brittCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sgai-goal

Compose GOAL.md files for SGAI workspaces through interactive conversation.

5|Updated Nov 9, 2025
Search Tags:#agent orchestration#success criteria#stack detection#sgai#interactive setup#goal.md#flow graph
One-click install
npx skills add https://github.com/britt/agent-skills --skill sgai-goal-britt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sgai-goal
Source: https://github.com/britt/agent-skills/tree/main/skills/sgai-goal
Command: npx skills add https://github.com/britt/agent-skills --skill sgai-goal-britt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting work in an SGAI-managed repository requires a correctly structured GOAL.md with an agent flow graph, model assignments, a completion gate, and outcome-based success criteria, which is error-prone to write by hand. ## Core Features & Use Cases - Stack Detection: Scans for go.mod, package.json, wrangler.toml, and similar files to select the right developer and reviewer agents. - Flow Graph Composition: Builds developer-to-reviewer-to-stpa-analyst agent chains, including multi-stack variants, backed by a full agent catalog reference. - Safe File Handling: Saves model preferences to .sgai/preferences.json and backs up any existing GOAL.md with a timestamped name before writing. - Use Case: You want to add OAuth authentication to a Go plus React app. The skill detects both stacks, drafts outcome-based success criteria, assembles a four-agent flow graph ending in stpa-analyst, sets go test as the completion gate, and writes the GOAL.md after your approval. ## Quick Start Ask the agent to create an SGAI goal for adding user authentication to this repository.

Frequently Asked Questions about sgai-goal

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

FAQPage Schema
How do I create a GOAL.md for an SGAI workspace?▼

Invoke the skill in an SGAI-managed repo and describe what you want to accomplish conversationally. It detects your tech stack, drafts outcome-based success criteria, builds an agent flow graph, shows a preview, and writes GOAL.md after your confirmation.

What agents can I use in an SGAI flow graph?▼

SGAI offers development agents like backend-go-developer and react-developer, review agents like go-readability-reviewer and stpa-analyst, plus verification, deployment, C4 documentation, and meta agents. The agents-reference.md file catalogs all of them with flow variants.

Does the skill work if my repo has no SGAI configuration?▼

No. The skill first checks for an .sgai/ directory or other SGAI configuration. If none is found, it stops and asks whether the repository actually uses SGAI before proceeding.

What happens to an existing GOAL.md when creating a new one?▼

The existing GOAL.md is renamed to GOAL.md.YYYY-MM-DD-HHMMSS.bak before the new file is written, and you are informed of the backup. The old goal file is never overwritten without a timestamped backup.

Why should success criteria be outcome-based instead of implementation steps?▼

Outcome-based criteria like "users can sign in with OAuth" describe verifiable end states, while implementation steps like "add login route" prescribe tasks that may not guarantee the goal. The skill drafts criteria as outcomes and asks you to confirm them.

Related Skills

Explore More Software Engineering Skills→
sandgardenhqsandgardenhq
130

knowledge

List agents, skills, and code snippets from a SGai workspace.

Official
Intermediate
sandgardenhqsandgardenhq
130

session-control

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

Official
Intermediate
flora131flora131
484

init

Generate CLAUDE.md and AGENTS.md files by analyzing a codebase for project metadata.

Community
Basic
sandgardenhqsandgardenhq
130

goal-md-composer

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

Official
Advanced