Agent skill

Goal Prompt

by techwolf-ai in techwolf-ai/ai-first-toolkit

Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must…

MITAuto-check passed

Install Goal Prompt

skills CLI
$ npx skills add techwolf-ai/ai-first-toolkit --skill goal-prompt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install techwolf-ai/ai-first-toolkit goal-prompt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/techwolf-ai/ai-first-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/session-tools/skills/goal-prompt .claude/skills/goal-prompt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
goal-prompt
GitHub stars
132
Token cost
~695 tokens
SKILL.md length
306 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must…

  • Works in 3 steps: Measurable end state — one concrete… → Stated proof — exactly how Claude… → Constraints that must not drift — what…
  • The user says give me a goal
  • SKILL.md covers Why the shape matters, A good goal has three parts, How to write it and Output, plus 1 more section
  • Calls jq

What it does

Goal Prompt is an agent skill from techwolf-ai/ai-first-toolkit. Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must not drift. Use when the user says "give me a goal", "goal prompt", "make this a /goal", "turn this into a goal", or wants an autonomous long-running objective for Claude Code.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-engineer, and bootstrap projects with AI-first design principles. The licence is MIT.

When your agent uses it

  • The user says give me a goal
  • Make this a /goal
  • Turn this into a goal
  • Wants an autonomous long-running objective for Claude Code

Example prompts

  • “give me a goal”
  • “goal prompt”
  • “make this a /goal”
  • “/goal-prompt”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Measurable end state — one concrete finish line: a test/exit code, a file that must exist, a count, an empty queue, named sections present.
  2. Stated proof — exactly how Claude demonstrates it: the command to run and its expected result, or the grep/check whose output shows done…
  3. Constraints that must not drift — what stays unchanged on the way there: files not to touch, framing to keep, no network/prod, don't…

What it can do on your machine

Read from SKILL.md and the folder at commit 2ee7841. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Goal Prompt loads about 695 tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~695

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from techwolf-ai/ai-first-toolkit at commit 2ee7841, republished under its MIT licence (© techwolf-ai). 306 words, ~695 tokens.

Download SKILL.mdSave it as .claude/skills/goal-prompt/SKILL.md (or your agent's skills folder).
name
goal-prompt
description
Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must not drift. Use when the user says "give me a goal", "goal prompt", "make this a /goal", "turn this into a goal", or wants an autonomous long-running objective for Claude Code.

goal-prompt

Produce a ready-to-paste /goal ... command from whatever the user is trying to accomplish.

Why the shape matters

/goal runs Claude autonomously until a separate fast-model evaluator decides, after a turn, that the condition is met. The evaluator does NOT run commands or read files itself — it only reads Claude's output. So the completion condition must be demonstrable by Claude's own output, never by hidden side effects.

A good goal has three parts

  1. Measurable end state — one concrete finish line: a test/exit code, a file that must exist, a count, an empty queue, named sections present.
  2. Stated proof — exactly how Claude demonstrates it: the command to run and its expected result, or the grep/check whose output shows done. Phrase it as "Prove it by showing X."
  3. Constraints that must not drift — what stays unchanged on the way there: files not to touch, framing to keep, no network/prod, don't modify tests.

How to write it

  • One sentence of objective, then Done when: <end state + proof>, then Constraints that must not change: <list>.
  • If the full spec is long, point to a plan/doc file (e.g. a path under ~/.claude/plans/ or docs/) and keep the goal itself scannable.
  • Make the proof something the transcript can show: prefer command exits 0 + a summary line, or grep for markers, over vague "it works".
  • Translate conditions the evaluator can't see ("the UI looks good") into an observable check.
  • Keep constraints tight enough to stop scope creep, not so rigid they block the obvious path.

Output

Give the user a single fenced block starting with /goal, then 2-3 lines explaining the end state, the proof, and why it's demonstrable. Nothing else.

Example

/goal Add a --json flag to the export CLI per docs/export-json.md. Done when: `pytest tests/test_export.py -q` exits 0 and `python -m app.export --json` prints valid JSON whose top-level keys include "rows" and "meta". Prove it by showing the pytest summary and the piped `... --json | jq keys` output. Constraints that must not change: only edit app/export.py and add tests/test_export.py; do not alter the existing CSV output path; no network.

Its finish line is a passing test plus a schema check, both visible in Claude's transcript; the constraints pin the blast radius so the autonomous run can't wander.

© techwolf-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/session-tools/skills/goal-prompt of techwolf-ai/ai-first-toolkit.

Open the folder on GitHubat commit 2ee7841

Compare with similar skills

Goal Prompt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Goal Prompt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goal Prompt this skilltechwolf-ai/ai-first-toolkit132—~695Automated safety check: PassMIT
Goalcwinvestments/memstack423—~1.6kAutomated safety check: PassMIT
Goaliurysza/module-graph420—~721Automated safety check: PassMIT
Goalcoco-research/coco513—~1.7kAutomated safety check: PassCustom licence
GoalKonghaYao/peri226—~391Automated safety check: PassApache-2.0
Goaljthack/claude-goal113—~503Automated safety check: PassMIT

Similar skills

  • Goal

    cwinvestments/memstack

    A skill your agent uses when the user says 'goal', 'set a goal', 'define the goal', 'plan this properly', or starts a task that needs a clear finish line and verification.

    423 GitHub stars~1.6k tokensUpdated 13 days ago
    Auto-check passed
  • Goal

    iurysza/module-graph

    Executes an approved goal package from ai-artifacts/goals. An agent skill from iurysza/module-graph.

    420 GitHub stars~721 tokensUpdated 2 days ago
    Auto-check passed
  • Goal

    coco-research/coco

    Persistent project goal that survives across sessions and tools, with continuous-execution loop semantics.

    513 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Goal

    KonghaYao/peri

    Long-running goal tracking. An agent skill from KonghaYao/peri.

    226 GitHub stars~391 tokensUpdated today
    Auto-check passed
  • Goal

    jthack/claude-goal

    Codex-style /goal for Claude Code. An agent skill from jthack/claude-goal.

    113 GitHub stars~503 tokensUpdated 5 mo ago
    Auto-check passed
  • Goals

    codewhale-hq/Codewhale

    Set, review, and update the user's goals. An agent skill from codewhale-hq/Codewhale.

    41k GitHub stars~273 tokensUpdated today
    Auto-check passed

More from techwolf-ai/ai-first-toolkit

All 29 skills in this repo
  • Task Profile

    techwolf-ai/ai-first-toolkit

    Mine the user's Claude Code + Cowork session history into a structured task profile, what they do with AI, how often, how successfully where friction lives, then propose atomic skills that would…

    132 GitHub stars~3.6k tokensUpdated 11 days ago
    Auto-check passed
  • Token Doctor

    techwolf-ai/ai-first-toolkit

    Personal diagnosis of where your Claude Code + Cowork spend goes.

    132 GitHub stars~4.1k tokensUpdated 11 days ago
    Auto-check passed
  • Session Search

    techwolf-ai/ai-first-toolkit

    Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac.

    132 GitHub stars~1.1k tokensUpdated 11 days ago
    Auto-check passed
  • Write Blog Post

    techwolf-ai/ai-first-toolkit

    Write or develop a blog post. An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~1.1k tokensUpdated 11 days ago
    Auto-check passed
  • Write Opinion

    techwolf-ai/ai-first-toolkit

    Write or develop an opinion piece (opiniestuk/op-ed). An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~695 tokensUpdated 11 days ago
    Auto-check passed
  • AI Firstify

    techwolf-ai/ai-first-toolkit

    Analyze, re-engineer, or bootstrap projects to align with AI-first design principles.

    132 GitHub stars~646 tokensUpdated 11 days ago
    Auto-check passed

Questions about Goal Prompt

What does Goal Prompt do?

Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must…. Goal Prompt is an agent skill from techwolf-ai/ai-first-toolkit. Turn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must not drift.

When should I use Goal Prompt?

Goal Prompt fits situations like: the user says give me a goal; make this a /goal; turn this into a goal; wants an autonomous long-running objective for Claude Code.

How do I install Goal Prompt in Claude Code?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill goal-prompt -a claude-code`. Or copy the skill folder (plugins/session-tools/skills/goal-prompt in techwolf-ai/ai-first-toolkit) into .claude/skills/goal-prompt in your project. Claude Code loads it when a task matches its description.

How do I install Goal Prompt in Codex?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill goal-prompt -a codex`. Or copy the skill folder (plugins/session-tools/skills/goal-prompt in techwolf-ai/ai-first-toolkit) into .agents/skills/goal-prompt in your project. Codex loads it when a task matches its description.

Can I use Goal Prompt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add techwolf-ai/ai-first-toolkit --skill goal-prompt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/goal-prompt, .gemini/skills/goal-prompt, .github/skills/goal-prompt and .opencode/skills/goal-prompt in your project.

What does Goal Prompt need to run?

Going by SKILL.md and its folder, Goal Prompt needs the command-line tools its instructions call (jq). Our summary lists: Python 3.

Does Goal Prompt access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Goal Prompt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Goal Prompt use?

Goal Prompt is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Goal Prompt use?

About 695 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Goal Prompt?

Skills that share tags, products or a category with Goal Prompt: Goal (cwinvestments/memstack, 423 stars), Goal (iurysza/module-graph, 420 stars), Goal (coco-research/coco, 513 stars) and Goal (KonghaYao/peri, 226 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Goal Prompt?

techwolf-ai (a GitHub organization) maintains it in techwolf-ai/ai-first-toolkit, which has 132 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 29, 2026.

Source: techwolf-ai/ai-first-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.