Agent Goal Skill

agent-goal-skill

**A Claude Code skill that turns rough goal descriptions into polished, doctrine-compliant agent prompts.**

Use it to shape `/goal` prompts for Codex, Claude Code, Droid, Auggie — any CLI agent that benefits from a structured goal contract.

🪞 Your Claude becomes a prompt shaper. Type a one-liner. Get back a tight, executable goal block ready to paste into any agent.

---

What problem this solves

Agent goal prompts fail in predictable ways:

• Verbose: 3 paragraphs of context the model derives from the codebase anyway
• Aspirational: "make the code clean" — not a binary criterion
• Under-constrained: no out-of-scope list, agent wanders
• No fail-fast clause: agent stalls on missing context, burns budget asking
• Wrong scope hints: token budget + sandbox level missing, agent picks badly

This skill enforces a **5-block doctrine** that closes all 5 failure modes. The shape is non-negotiable — what plugs into the blocks is what you bring.

---

The 5-block doctrine

Every shaped goal has exactly these blocks, in this order, with markdown headers:

# Goal           — one-line verifiable outcome
# Context        — facts the agent can't derive (paths, IDs, prior decisions)
# Constraints    — hard rules + out-of-scope
# Done when      — numbered binary criteria (shell commands ideal)
# On block       — fail-fast clause + where to drop questions

Plus three out-of-band hints emitted alongside the block:

• Sandbox — read-only | workspace-write | danger-full-access
• Reasoning effort — medium | high | xhigh
• Token budget — sized to scope (~500K for single feature, ~5M for multi-day sprint)

Full doctrine: [`doctrine.md`](./doctrine.md).

---

Install

Claude Code

git clone https://github.com//agent-goal-skill.git ~/.claude/skills/agent-goal-skill

Restart Claude Code. The skill auto-registers — invoke via `/agent-goal-skill `.

Codex CLI