Skip to content
Back to search

goal-setter-skill

Shape rough requests into evidence-backed /goal completion contracts — an Agent Skill for Claude Code and Codex

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gotalab--goal-setter-skill/badge.svg)](/listings/gotalab--goal-setter-skill)

HTML

<a href="/listings/gotalab--goal-setter-skill"><img src="/api/listings/gotalab--goal-setter-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Pick one install path:

| If you use | Install | Invoke with | | --- | --- | --- | | Codex App `/plugins` | Codex App Plugin | `$goal-setter:goal-setter ...` | | Codex local skills | Codex Skill | `$goal-setter ...` | | Claude Code | Claude Code marketplace | `/goal-setter:goal-setter ...` | | Another agent with Skills CLI support | Skills CLI | the agent's skill invocation syntax |

Most Codex App users should install only the **Codex App Plugin**.

Codex App Plugin

In Codex, open `/plugins`, choose **Add plugin marketplace**, and enter:

Source: gotalab/goal-setter-skill
Git ref: main
Sparse paths: plugins/goal-setter

Then install **Goal Setter** from the Plugins screen.

Codex Skill

In Codex chat:

$skill-installer install https://github.com/gotalab/goal-setter-skill/tree/main/skills/goal-setter

Restart Codex, then invoke with `$goal-setter`.

Claude Code

/plugin marketplace add gotalab/goal-setter-skill
/plugin install goal-setter@goal-setter

Invoke with `/goal-setter:goal-setter`.

Skills CLI

npx skills add gotalab/goal-setter-skill

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "goal-setter",
  3. "description": "Single-plugin marketplace for goal-setter: compact, outcome-first /goal completion contracts for long autonomous runs.",
  4. "owner": {
  5. "name": "gotalab"
  6. },
  7. "plugins": [
  8. {
  9. "name": "goal-setter",
  10. "source": "./",
  11. "description": "Shape rough requests into compact, outcome-first /goal completion contracts before long autonomous runs.",
  12. "category": "productivity"
  13. }
  14. ]
  15. }
README.md · README · 140 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # goal-setter
  2. **Turn rough long-running work into a compact Codex `/goal` with a clear finish line.**
  3. goal-setter is a Codex skill for work that needs more than a one-off prompt. It
  4. turns a rough request into a short goal that fixes the result, the evidence for
  5. success, the boundaries, and the stop rules, while leaving implementation
  6. judgment to the runner.
  7. It favors verification targets over rule-heavy procedures: the goal should say
  8. what must be proven, not prescribe every step.
  9. Built for **Codex**. Works on **Claude Code** too.
  10. [日本語](README.ja.md)
  11. <p align="center">
  12. <img src="assets/goal-setter-icon.png" alt="Goal Setter icon: loose requests converging into a checked goal" width="180">
  13. </p>
  14. ## When to Use It
  15. Do not turn every request into a Goal. Use goal-setter when the work can keep
  16. going across several checks and the finish line must be judged by evidence.
  17. | Work | Better format |
  18. | --- | --- |
  19. | One clear edit, explanation, or review | Normal prompt |
  20. | Narrow work that may need a few tries | One sentence or short paragraph Goal |
  21. | Migration, performance work, broad bug fixing, or evidence-backed research | Standard Goal |
  22. | Long research or high-risk change | Goal plus the smallest needed plan, checklist, or evaluation file |
  23. ## What It Does
  24. - Reconstructs the intended result before drafting.
  25. - Adds only clauses that change the result, evidence, boundary, risk, or stop
  26. decision.
  27. - Interviews one material question at a time when the request is too ambiguous
  28. for an honest Goal and each answer determines the next question; bundles
  29. independent blockers.
  30. - Keeps Goal intake focused and requires only delegation that can improve the
  31. completion decision. Existing agents continue related work; new agents handle
  32. independent work or independent verification. Separate tasks remain
  33. user-directed.
  34. Details live in [docs/RUNTIME.md](docs/RUNTIME.md). Examples live in
  35. [docs/EXAMPLES.md](docs/EXAMPLES.md).
  36. ## Install
  37. Pick one install path:
  38. | If you use | Install | Invoke with |
  39. | --- | --- | --- |
  40. | Codex App `/plugins` | Codex App Plugin | `$goal-setter:goal-setter ...` |
  41. | Codex local skills | Codex Skill | `$goal-setter ...` |
  42. | Claude Code | Claude Code marketplace | `/goal-setter:goal-setter ...` |
  43. | Another agent with Skills CLI support | Skills CLI | the agent's skill invocation syntax |
  44. Most Codex App users should install only the **Codex App Plugin**.
  45. ### Codex App Plugin
  46. In Codex, open `/plugins`, choose **Add plugin marketplace**, and enter:
  47. ```text
  48. Source: gotalab/goal-setter-skill
  49. Git ref: main
  50. Sparse paths: plugins/goal-setter
  51. ```
  52. Then install **Goal Setter** from the Plugins screen.
  53. ### Codex Skill
  54. In Codex chat:
  55. ```text
  56. $skill-installer install https://github.com/gotalab/goal-setter-skill/tree/main/skills/goal-setter
  57. ```
  58. Restart Codex, then invoke with `$goal-setter`.
  59. ### Claude Code
  60. ```text
  61. /plugin marketplace add gotalab/goal-setter-skill
  62. /plugin install goal-setter@goal-setter
  63. ```
  64. Invoke with `/goal-setter:goal-setter`.
  65. ### Skills CLI
  66. ```bash
  67. npx skills add gotalab/goal-setter-skill
  68. ```
  69. ## Usage
  70. Draft a goal without activating it:
  71. ```text
  72. $goal-setter draft a goal for migrating our API client to v2
  73. ```
  74. Shape and activate a goal:
  75. ```text
  76. $goal-setter set a goal: all checkout tests pass after the refactor
  77. ```
  78. goal-setter sets the Goal through Codex's native Goal mechanism. When delegated
  79. work can materially improve Done, the Goal names the work and evidence without
  80. embedding agent counts, models, tool arguments, or a fixed sequence. During the
  81. run, related follow-up stays with the agent that already has the context; a new
  82. agent is used for independent work or a clean independent review. The lead keeps
  83. integration, important decisions, final verification, and Done. `create_thread`
  84. creates separate user-owned tasks, so it is used only when the user explicitly
  85. requests separate tasks, threads, or worktrees.
  86. ## Docs
  87. - [Examples](docs/EXAMPLES.md)
  88. - [Runtime behavior](docs/RUNTIME.md)
  89. - [Changelog](CHANGELOG.md)
  90. ## Repository
  91. ```text
  92. skills/goal-setter/SKILL.md # the skill
  93. skills/goal-setter/scripts/ # goal length validator
  94. scripts/ # packaging and release checks
  95. plugins/goal-setter/ # Codex plugin bundle
  96. .claude-plugin/ # Claude Code plugin metadata
  97. ```
  98. ## License
  99. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.