Skip to content
SkillMixed1,255 tokens in use

goal-prompt

Drafts one-line /goal commands for Claude Code and Codex that have a checkable end state, a stated check, invariants and a stop bound.

8,319 stars on the repository CC-BY-SA-4.0trailofbits/skills · plugins/goal-prompt/skills/goal-prompt
/plugin marketplace add trailofbits/skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing goal-prompt costs

67tokens idle
1,255tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/format_goal_prompt.py, scripts/test_format_goal_prompt.py.

Touches

shelldeclared and detectedwrites filesdeclared and detected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure19/25
  • Examples12/15
  • Output15/15
  • Size15/15
  • Resources0/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Writes files−4

    does this on the machine, as the frontmatter declares

    scripts/test_format_goal_prompt.py, line 62

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance52
  • Community64
  • Maturity32
  • Momentum40

Goal Prompt helps write the condition behind /goal, the command that keeps an agent working until a completion condition is met. It drafts an end state that can be true or false, names the files to read first, the exact check command and its expected result, what must not change, and when to stop.

It then closes the cheapest easy-outs, such as deleting code so a search check passes, and formats the result as a single copy-ready line under the 4,000 character limit.

What You Get

  • A single-line /goal command in a fenced text block
  • A Missing: list for any element that could not be grounded in your request or repository
  • Checks paired so the cheapest shortcuts stop working
  • Advice to move long briefs into a GOAL.md and a progress log file

Common Use Cases

  • Turning a vague task such as a migration into a goal with a test command and a zero-matches check
  • Rewriting an existing goal that loops forever
  • Setting up a long-running audit goal with a threat model file
  • Compressing a long brief to fit the character limit

What Makes It Unique

It focuses on how a goal is judged: in Claude Code a small model re-judges the condition from the transcript alone after each turn, so the skill requires checks to be run with output shown and joins conditions with AND. It never invents missing pieces and lists gaps for you to fill, such as the metric or threshold behind “faster”. A security section collapses audit goals to one terminating criterion and asks for a second validation pass by a fresh agent.

Under The Hood

The skill is prose plus a small Python script that the agent runs through uv in the shell. The script reads a draft from a file or stdin, collapses whitespace, strips a leading /goal, quotes and fences, checks for a stop clause and the length limit, and prints the result. It makes no network calls. The agent may read repository files such as package.json to ground the check command, and may write a draft file.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers