Agent skill

Agent Goal

by EpicenterHQ in EpicenterHQ/epicenter

Draft a /goal line that gives long-running Codex or Claude Code work an objective, validation evidence, and a stop condition.

Custom licenceAuto-check passed

Install Agent Goal

skills CLI
$ npx skills add EpicenterHQ/epicenter --skill agent-goal -a claude-code

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

GitHub CLI
$ gh skill install EpicenterHQ/epicenter agent-goal --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/EpicenterHQ/epicenter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-goal .claude/skills/agent-goal && 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
agent-goal
GitHub stars
4.8k
Token cost
~620 tokens
SKILL.md length
297 words
Files
1
Skills in repo
65
Repo updated
First seen
Licence
Custom licence

At a glance

Draft a /goal line that gives long-running Codex or Claude Code work an objective, validation evidence, and a stop condition.

  • Works in 7 steps: Start the answer with /goal when the… → Make completion judgeable by someone who… → Prefer exact checks over vague proof:… → …
  • The user explicitly asks for /goal
  • SKILL.md covers Shape, Rules, Platform Note and Check
  • Calls bun

What it does

Agent Goal is an agent skill from EpicenterHQ/epicenter. Draft a /goal line that gives long-running Codex or Claude Code work an objective, validation evidence, and a stop condition. Use when the user explicitly asks for /goal, an agent goal, or a completion condition.

Its SKILL.md is about 620 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, local-first apps.

When your agent uses it

  • The user explicitly asks for /goal
  • A completion condition

Example prompts

  • “/agent-goal”

Workflow steps

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

  1. Start the answer with /goal when the user asks for the goal text.
  2. Make completion judgeable by someone who can only read the transcript.
  3. Prefer exact checks over vague proof: "bun test packages/auth exits 0" beats "tests pass."
  4. Point long requirements at a file instead of pasting them into the goal.
  5. Ask for checkpoints when the work spans multiple turns.
  6. Bound repeated failure: after three failed attempts on the same check, report the root cause and next decision.
  7. Do not create a /goal for vague wishes, open-ended research, unrelated chores, or work with no observable evidence.

What it can do on your machine

Read from SKILL.md and the folder at commit 5b4bb69. 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:

    • bun

    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

Agent Goal loads about 620 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 297 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 297 words (~620 tokens).

“Write one /goal line that a coding agent can keep pursuing until the transcript proves the work is done.”

— opening of SKILL.md by EpicenterHQ, Custom licence
name
agent-goal

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/agent-goal of EpicenterHQ/epicenter.

Open the folder on GitHubat commit 5b4bb69

Compare with similar skills

Agent Goal 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.

Agent Goal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Goal this skillEpicenterHQ/epicenter4.8k—~620Automated safety check: PassCustom licence
Goalscodewhale-hq/Codewhale41k—~273Automated safety check: PassMIT
Agent Goal Plannerruvnet/ruflo74k2 repos~842Automated safety check: PassMIT
Goal Planruvnet/ruflo74k—~807Automated safety check: NotesMIT
Goal Loopsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Agent Code Goal Plannerruvnet/ruflo74k2 repos~3.6kAutomated safety check: PassMIT

Similar skills

  • 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
  • Agent Goal Planner

    ruvnet/ruflo

    Agent skill for goal-planner - invoke with $agent-goal-planner

    74k GitHub starsUsed in 2 repos~842 tokens
    Auto-check passed
  • Goal Plan

    ruvnet/ruflo

    Create and execute Goal-Oriented Action Plans (GOAP) with precondition analysis, cost optimization, and adaptive replanning

    74k GitHub stars~807 tokensUpdated today
    Auto-check: notes
  • Goal Loop

    sickn33/agentic-awesome-skills

    Draft and explain persistent goal-loop prompts for long-running agent work with clear stop conditions.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Agent skill for code-goal-planner - invoke with $agent-code-goal-planner

    74k GitHub starsUsed in 2 repos~3.6k tokens
    Agent WorkflowsAuto-check passed
  • Fable Goal

    alirezarezvani/claude-skills

    Convert a rambling description of a desired outcome into one polished, autonomous /goal prompt ready to paste into a fresh session.

    28k GitHub stars~2.4k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from EpicenterHQ/epicenter

All 65 skills in this repo
  • Agent Instructions

    EpicenterHQ/epicenter

    Write and maintain repository guidance across AGENTS.md, CLAUDE.md, and .agents/skills.

    4.8k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Consult Claude

    EpicenterHQ/epicenter

    Assign Claude Code a read-only investigation, recommendation, or finished text draft.

    4.8k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Better Auth security hardening: rate limits, secrets, CSRF, trusted origins, cookies, sessions, OAuth tokens, and audit logging.

    4.8k GitHub stars~896 tokensUpdated 2 days ago
    Auto-check passed
  • Cohesion Over Testability

    EpicenterHQ/epicenter

    Collapse test-shaped production boundaries while preserving behavior and coverage.

    4.8k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Collapse Pass

    EpicenterHQ/epicenter

    Remove indirection that does not earn its boundary across a diff or package.

    4.8k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Error Handling

    EpicenterHQ/epicenter

    Apply Wellcrafted Result patterns to fallible operations and preserve failures at boundaries.

    4.8k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

Questions about Agent Goal

What does Agent Goal do?

Draft a /goal line that gives long-running Codex or Claude Code work an objective, validation evidence, and a stop condition. Agent Goal is an agent skill from EpicenterHQ/epicenter. Draft a /goal line that gives long-running Codex or Claude Code work an objective, validation evidence, and a stop condition.

When should I use Agent Goal?

Agent Goal fits situations like: the user explicitly asks for /goal; A completion condition.

How do I install Agent Goal in Claude Code?

Run `npx skills add EpicenterHQ/epicenter --skill agent-goal -a claude-code`. Or copy the skill folder (.agents/skills/agent-goal in EpicenterHQ/epicenter) into .claude/skills/agent-goal in your project. Claude Code loads it when a task matches its description.

How do I install Agent Goal in Codex?

Run `npx skills add EpicenterHQ/epicenter --skill agent-goal -a codex`. Or copy the skill folder (.agents/skills/agent-goal in EpicenterHQ/epicenter) into .agents/skills/agent-goal in your project. Codex loads it when a task matches its description.

Can I use Agent Goal 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 EpicenterHQ/epicenter --skill agent-goal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-goal, .gemini/skills/agent-goal, .github/skills/agent-goal and .opencode/skills/agent-goal in your project.

What does Agent Goal need to run?

Going by SKILL.md and its folder, Agent Goal needs the command-line tools its instructions call (bun).

Does Agent Goal 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 Agent Goal 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 Agent Goal use?

Agent Goal has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Agent Goal use?

About 620 tokens (SKILL.md is roughly 2.5k 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 Agent Goal?

Skills that share tags, products or a category with Agent Goal: Goals (codewhale-hq/Codewhale, 41k stars), Agent Goal Planner (ruvnet/ruflo, 74k stars), Goal Plan (ruvnet/ruflo, 74k stars) and Goal Loop (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Goal?

EpicenterHQ (a GitHub organization) maintains it in EpicenterHQ/epicenter, which has 4,822 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on October 8, 2026.

Source: EpicenterHQ/epicenter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.