write-a-goal SKILL.md skillA
write-a-goal from hamza-ali-shahjahan/hamzaish is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hamza-ali-shahjahan/hamzaish/write-a-goal@git:20260620.5e27b4ePins git:20260620.5e27b4e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hamza-ali-shahjahan/hamzaish
- Path
factory/skills/write-a-goal/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260620.5e27b4e, committed Jun 20, 2026
- First version recorded
- Jun 20, 2026
- Size
- 5,066 bytes
- Repository stars
- 10
- License
- MIT
Turn a rough ambition into a measurable, REACHABLE goal — a capability statement, a precisely-named metric, ≥2 numeric evals, an acceptance rule, and non-goals — with a feasibility check that catches impossible or game-able targets before you chase them. Pair with /goal (which pursues a goal autonomously).
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# /write-a-goal Usage: `/write-a-goal <the ambition, or what "good" looks like>` A goal you can't measure is a wish. A goal you can't reach is a trap. A goal a degenerate output can fake is a lie. This skill turns an ambition into a goal that `/goal` can autonomously pursue and a fresh-eyes agent can actually certify — **and it refuses to hand you a target that's impossible or game-able.** ## The shape a good goal must clear 1. **Capability statement** — one sentence: *"Given X, the system does Y."* Concrete, observable. 2. **The exact metric** — the single thing measured, named precisely enough that two people would compute the same number (see Check A). 3. **≥2 numeric evals** — real test cases, each with a target number and how it's scored. One eval is an anecdote; two+ is a bar. 4. **Acceptance rule** — when is it *done*? (e.g. "every eval ≥ target on a fresh run, confirmed by a fresh-eyes agent.") 5. **Non-goals** — what this explicitly is *not*, so the loop doesn't gold-plate the wrong thing. ## The two checks that make or break it (hard-won) ### Check A — Pin the exact metric (kill vague percentages) …
Read the whole file at its exact version.
How to install
mdr add hamza-ali-shahjahan/hamzaish/write-a-goal@sha256:67b9f9f437ba04f3The line at the top of this page pins the label git:20260620.5e27b4e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_42ndq4xbagzgjnov)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Jun 20, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260620.5e27b4e latest | 2026-06-20 | 5e27b4e | 5,066 B | A | view · diff |
| git:20260620.55afa35 | 2026-06-20 | 55afa35 | 5,060 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5066 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
hamza-ali-shahjahan/hamzaish · 10 stars · license MIT · pushed 2026-10-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_42ndq4xbagzgjnov GET https://markdownregistry.com/api/v1/resolve?ref=hamza-ali-shahjahan/hamzaish/write-a-goal GET https://markdownregistry.com/api/v1/blob/67b9f9f437ba04f3f9397268accad3f0abe11c865b44fd8f616af549c038ce5d
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.