Agent skill

Goal

by coco-research in coco-research/coco

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

Custom licenceAuto-check passed

Install Goal

skills CLI
$ npx skills add coco-research/coco --skill goal -a claude-code

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

GitHub CLI
$ gh skill install coco-research/coco 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/coco-research/coco.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/goal .claude/skills/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
goal
GitHub stars
482
Token cost
~1.7k tokens
SKILL.md length
894 words
Files
1
Skills in repo
57
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 6 steps: Resume — read .goal.md plus the newest… → Pick the highest-priority item that is… → Journal before acting — append TODO to… → …
  • Someone asks to set a goal
  • SKILL.md covers State file, API, Session behavior and Work loop (continuous execution), plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Goal is an agent skill from coco-research/coco. Persistent project goal that survives across sessions and tools, with continuous-execution loop semantics. Use when someone asks to "set a goal", "what is my goal", "goal status", "keep working on X until done", "resume the goal", or wants work to continue across sessions until an objective is achieved. File-backed (.goal.md at project root); shared by every Coco-installed tool working in that repository.

Its SKILL.md is about 1.7k 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: CoCo Super Intelligence is the orchestration layer that turns Claude Code, Cursor, or Codex into an engineering department: a routed advisory board, 226 skills, 386 commands…

When your agent uses it

  • Someone asks to set a goal
  • What is my goal
  • Keep working on X until done
  • Resume the goal

Example prompts

  • “set a goal”
  • “what is my goal”
  • “goal status”
  • “/goal”

Workflow steps

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

  1. Resume — read .goal.md plus the newest handoff document it references
  2. Pick the highest-priority item that is actionable right now — from the
  3. Journal before acting — append TODO to ## Progress. If the
  4. Execute — do the work. Run the real gates. Commit/PR per whatever
  5. Journal after — append DONE — immediately. Receipt =
  6. Repeat from step 2 while an actionable item remains and no STOP

What it can do on your machine

Read from SKILL.md and the folder at commit 2ddb559. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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 loads about 1.7k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 894 words of instructions outside code blocks.

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

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 894 words (~1,704 tokens).

“A goal is a single objective the agent keeps pursuing across turns and sessions until it is marked done. Inspired by Prime Agent's thread goal: state lives outside any one conversation, so any tool with this skill installed (Claude Code…”

— opening of SKILL.md by coco-research, Custom licence
name
goal
domain
meta

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/goal of coco-research/coco.

Open the folder on GitHubat commit 2ddb559

Compare with similar skills

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.

Goal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goal this skillcoco-research/coco482—~1.7kAutomated safety check: PassCustom licence
Session Persistruvnet/ruflo74k—~415Automated safety check: NotesMIT
Goalscodewhale-hq/Codewhale41k—~273Automated safety check: PassMIT
Session Handoffsickn33/agentic-awesome-skills47k—~1.8kAutomated safety check: NotesMIT
Sessionanthropics/claude-for-legal9.6k3 repos~478Automated safety check: PassApache-2.0
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Session Persist

    ruvnet/ruflo

    Persist and restore agent sessions across conversations with state snapshots

    74k GitHub stars~415 tokensUpdated today
    Auto-check: notes
  • 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
  • Session Handoff

    sickn33/agentic-awesome-skills

    A skill your agent uses when context approaches capacity, before /clear or /compact, when switching tasks, or when ending a coding session: produces a structured handoff artifact for the next session.

    47k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Session

    anthropics/claude-for-legal

    Official

    Run a focused N-question study session on a subject — MBE, essay, or flashcards.

    9.6k GitHub starsUsed in 3 repos~478 tokens
    EducationAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Session Handoff

    davila7/claude-code-templates

    Creates comprehensive handoff documents for seamless AI agent session transfers.

    32k GitHub starsUsed in 2 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

More from coco-research/coco

All 57 skills in this repo
  • Arch Index

    coco-research/coco

    Build and validate .arch/index.json — a committed map from each architectural component of this repository to the real directories and files that implement it, pinned to a git commit, with every…

    482 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Skill Evolution

    coco-research/coco

    A skill your agent uses when running, reviewing or changing coco's self-evolution cycle: the 30-day loop that observes how skills are actually used, proposes evidence-backed edits to them as one…

    482 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Coco Diagram

    coco-research/coco

    A skill your agent uses for architecture, current-state, process, data-flow, medallion, or DP diagrams, including redrawing .drawio and Mermaid sources.

    482 GitHub stars~9.2k tokensUpdated yesterday
    Auto-check passed
  • M0

    coco-research/coco

    A skill your agent uses when the user says 'm0', 'm0 status', 'start m0', 'cross-tool memory', 'operational thread', or 'where is my memory stored', or when the M0 daemon or MCP wiring needs…

    482 GitHub stars~755 tokensUpdated yesterday
    Auto-check passed
  • PR To Video

    coco-research/coco

    A skill your agent uses when the user wants a GitHub PR (URL, owner/repoN, or 'this PR') made into a code-change explainer video from its diff and commits: changelog, feature reveal, fix, or refactor.

    482 GitHub stars~7.8k tokensUpdated yesterday
    Auto-check: notes
  • Website To Video

    coco-research/coco

    A skill your agent uses when the user wants a video of a website (site tour, portfolio, docs or landing-page showcase) captured from a URL.

    482 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check: notes

Questions about Goal

What does Goal do?

Persistent project goal that survives across sessions and tools, with continuous-execution loop semantics. Goal is an agent skill from coco-research/coco. Persistent project goal that survives across sessions and tools, with continuous-execution loop semantics.

When should I use Goal?

Goal fits situations like: someone asks to set a goal; what is my goal; keep working on X until done; resume the goal.

How do I install Goal in Claude Code?

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

How do I install Goal in Codex?

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

Can I use 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 coco-research/coco --skill 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/goal, .gemini/skills/goal, .github/skills/goal and .opencode/skills/goal in your project.

What does Goal need to run?

SKILL.md names no scripts, command-line tools or credentials: Goal is instructions for the agent only.

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

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

About 1.7k tokens (SKILL.md is roughly 6.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?

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

Who maintains Goal?

coco-research (a GitHub user) maintains it in coco-research/coco, which has 482 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on October 8, 2026.

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