agentleFS
marslomarslo/skills/goal/SKILL.md

goal

Skill0 starsChanged 2 months agoMITView on GitHub

Set a goal that Cursor will pursue to completion.

47 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 10 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 43 edited versions we read keep these.

  • 10

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use the same durable, tool-driven flow in local and cloud environments.

    line 8
  2. Very specific:

    If the objective is empty, show Usage: /goal <objective>.

    line 14
  3. Very specific:

    If the request leads with a time limit such as 30m or 2h, say plainly that time-limited goals are not supported yet, then create the goal …

    line 16
  4. Very specific:

    Call CreateGoal exactly once with the objective.

    line 22
  5. Distinctive:

    If creation fails, report that no goal was armed.

    line 23
  6. Distinctive:

    Keep the full objective intact.

    line 30
  7. Distinctive:

    Use the current working tree and external state as authoritative.

    line 34
  8. Distinctive:

    Do not substitute a narrower, safer, smaller, merely compatible, or easier-to-test solution because it is more likely to pass current tests.

    line 41
  9. Distinctive:

    Treat alignment as movement toward the requested end state.

    line 42
  10. Distinctive:

    Before deciding that the goal is achieved, treat completion as unproven and verify it against the actual current state:

    line 45
  11. Distinctive:

    Treat tests, manifests, verifiers, green checks, and search results as evidence only after confirming they cover the relevant requirement.

    line 51
  12. Distinctive:

    Treat uncertain or indirect evidence as not achieved.

    line 52
  13. Distinctive:

    Do not call UpdateGoal unless the goal is complete or the user paused the goal and wants to resume.

    line 57

“Common” is measured: kept by at least 6 in 10 of the 43 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Goal

Use the same durable, tool-driven flow in local and cloud environments.

Parse

Accept /goal <objective>.

  • If the objective is empty, show Usage: /goal <objective>.
  • There is no deadline, token budget, or turn budget. A goal continues until it is complete.
  • If the request leads with a time limit such as 30m or 2h, say plainly that time-limited goals are not supported yet, then create the goal without one rather than folding the limit into the objective.
  • "Every" describes recurring work and belongs to /loop, not /goal.

Start

  1. Restate the objective clearly, including every explicit deliverable or required evidence you will verify against the repo.
  2. Call CreateGoal exactly once with the objective. Do not create goal files manually or retry creation.
  3. If creation fails, report that no goal was armed. Goal state lives in conversation state; ordinary file tools may keep optional scratchpads, but continuation does not require them.
  4. Perform the first concrete unit of work immediately in this turn; do not stop after planning or creating the goal.

Guidelines

Continuation behavior:

  • This goal persists across turns. Ending this turn does not require shrinking the objective to what fits now.
  • Keep the full objective intact. If it cannot be finished now, make concrete progress toward the real requested end state, leave the goal active, and do not redefine success around a smaller or easier task.
  • Temporary rough edges are acceptable while the work is moving in the right direction. Completion still requires the requested end state to be true and verified.

Work from evidence: Use the current working tree and external state as authoritative. Previous conversation context can help locate relevant work, but inspect the current state before relying on it. Improve, replace, or remove existing work as needed to satisfy the actual objective.

Progress visibility: If TodoWrite is available and the next work is meaningfully multi-step, use it to show a concise plan tied to the real objective. Keep the plan current as steps complete or the next best action changes. Skip planning overhead for trivial one-step progress, and do not treat a plan update as a substitute for doing the work.

Fidelity:

  • Optimize each turn for movement toward the requested end state, not for the smallest stable-looking subset or easiest passing change.
  • Do not substitute a narrower, safer, smaller, merely compatible, or easier-to-test solution because it is more likely to pass current tests.
  • Treat alignment as movement toward the requested end state. An edit is aligned only if it makes the requested final state more true; useful-looking behavior that preserves a different end state is misaligned.

Completion audit: Before deciding that the goal is achieved, treat completion as unproven and verify it against the actual current state:

  • Derive concrete requirements from the objective and any referenced files, plans, specifications, issues, or user instructions.
  • Preserve the original scope; do not redefine success around the work that already exists.
  • For every explicit requirement, numbered item, named artifact, command, test, gate, invariant, and deliverable, identify the authoritative evidence that would prove it, then inspect the relevant current-state sources: files, command output, test results, PR state, rendered artifacts, runtime behavior, or other authoritative evidence.
  • For each item, determine whether the evidence proves completion, contradicts completion, shows incomplete work, is too weak or indirect to verify completion, or is missing.
  • Match the verification scope to the requirement's scope; do not use a narrow check to support a broad claim.
  • Treat tests, manifests, verifiers, green checks, and search results as evidence only after confirming they cover the relevant requirement.
  • Treat uncertain or indirect evidence as not achieved; gather stronger evidence or continue the work.
  • The audit must prove completion, not merely fail to find obvious remaining work.

Do not rely on intent, partial progress, memory of earlier work, or a plausible final answer as proof of completion. Marking the goal complete is a claim that the full objective has been finished and can withstand requirement-by-requirement scrutiny. Only mark the goal achieved when current evidence proves every requirement has been satisfied and no required work remains. If the evidence is incomplete, weak, indirect, merely consistent with completion, or leaves any requirement missing, incomplete, or unverified, keep working instead of marking the goal complete. If the objective is achieved, call UpdateGoal with status "complete" so usage accounting is preserved.

Do not call UpdateGoal unless the goal is complete or the user paused the goal and wants to resume. Do not mark a goal complete merely because you are stopping work.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.