goal-test SKILL.md skillA

goal-test from undefined-ui/second-brain-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add undefined-ui/second-brain-os/goal-test@git:20261007.c7fa35b

Pins git:20261007.c7fa35b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
undefined-ui/second-brain-os
Path
plugins/agents-course/skills/goal-test/SKILL.md
Versions recorded
2
Latest version
git:20261007.c7fa35b, committed Oct 7, 2026
First version recorded
Sep 29, 2026
Size
3,027 bytes
Repository stars
1,109
License
MIT

Turn a vague task into a testable definition of done and generate an executable goal-test script for it, optionally with a bounded retry loop around a headless agent. Use when the user wants to run an agent in a loop, asks how to know when an agent task is finished, or says a goal like "improve X" needs to become checkable. Do NOT use for building eval suites over many cases — that is evals-bootstrap.

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 done as a script

Theory: [The four parts of a loop](https://secondbrainos.dev/#/read/course-2-loop/the-four-parts)
and the [goal test build page](https://secondbrainos.dev/#/read/track-loop/build-goal-test).
"Improve the error handling" cannot terminate a loop, because nothing can ever
say it is finished. The goal must be phrased so that a program — not a person,
not the model — returns true or false against it.

## Workflow

1. **Extract the claim.** Ask what the user wants true at the end, then
   restate it as verifiable facts: which command exits 0, which file exists,
   which string appears, which number crosses which threshold. If a part
   cannot be checked by a program, say so and negotiate it down to what can.
2. **Prefer checks that already exist.** The test suite, the linter, the
   build, the type checker. A goal test that shells out to `make test` is
   better than one that reimplements it.
3. **Write `goal-test.sh`** (or `.py` if the checks are easier there) in the
   project root: runs every check, prints one line per check with pass/fail,
   exits 0 only when all pass. Keep it under ~40 lines; it must run in
   seconds and be safe to run repeatedly.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add undefined-ui/second-brain-os/goal-test@sha256:bd786edfdd22e413

The line at the top of this page pins the label git:20261007.c7fa35b, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_55ucmczaxx7g65j5.svg)](https://markdownregistry.com/a/art_55ucmczaxx7g65j5)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 29, 2026 and Oct 7, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261007.c7fa35b latest2026-10-07 c7fa35b 3,027 BA view · diff
git:20260929.fd3a5232026-09-29 fd3a523 3,057 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3027 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

GitHub

undefined-ui/second-brain-os · 1,109 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_55ucmczaxx7g65j5
GET https://markdownregistry.com/api/v1/resolve?ref=undefined-ui/second-brain-os/goal-test
GET https://markdownregistry.com/api/v1/blob/bd786edfdd22e413dcd80eac6575bf3a9cd2cb0efa1abec81452e81255bf1023

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.

More from undefined-ui/second-brain-os

context-audit SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/context-audit/SKILL.md · Audit an agent's context layout against the four places: system prompt, tools, history, tail. Use when the user asks to…
git:20261007.c7fa35b · audit A · 1,109 stars
evals-bootstrap SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/evals-bootstrap/SKILL.md · Scaffold a first eval suite for an agent: mine real failures into cases, write behavioural checks over traces, and…
git:20261007.c7fa35b · audit A · 1,109 stars
gate-check SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/gate-check/SKILL.md · Find the decisions in a pipeline that do not need the expensive model and propose the gate for each: a rule, a classic…
git:20261007.c7fa35b · audit A · 1,109 stars
harness-audit SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/harness-audit/SKILL.md · Audit an agent's harness against the four rings: containment, guides, sensors, permissions. Use when the user asks…
git:20261007.c7fa35b · audit A · 1,109 stars
second-brain-backfill SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-backfill/SKILL.md · Import a large archive into the vault in controlled batches: triage what is worth ingesting, process oldest first…
git:20260908.1615b29 · audit A · 1,109 stars
second-brain-changed-my-mind SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-changed-my-mind/SKILL.md · Trace where the user's recorded position on something has shifted: superseded claims, contradictions between sources of…
git:20260908.1615b29 · audit A · 1,109 stars
second-brain-chat-import SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-chat-import/SKILL.md · Triage an exported chat history into what to ingest, what to archive and what to delete, with a privacy pass first. Use…
git:20260908.1615b29 · audit A · 1,109 stars
second-brain-graph SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-graph/SKILL.md · Analyse the vault's link graph and report on its shape: orphan rate, average degree, components, hubs, bridges and…
git:20260908.1615b29 · audit A · 1,109 stars
second-brain-ingest SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-ingest/SKILL.md · Turn raw source material in a second-brain vault into linked wiki pages: read the source, split it into concepts and…
git:20260907.8c47c65 · audit A · 1,109 stars
second-brain-lint SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-lint/SKILL.md · Audit a second-brain vault for structural problems and repair them: broken wikilinks, orphan pages, empty stubs…
git:20260907.8c47c65 · audit A · 1,109 stars
second-brain-merge SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-merge/SKILL.md · Merge two pages that describe the same thing, preserving every distinct claim, redirecting inbound links, and recording…
git:20260908.1615b29 · audit A · 1,109 stars
second-brain-metrics SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-metrics/SKILL.md · Record a dated snapshot of the vault's health numbers and compare against previous snapshots so trends are visible. Use…
git:20260908.1615b29 · audit A · 1,109 stars

Every file in undefined-ui/second-brain-os

Other files named goal-test

goal-test SKILL.md skill
restarter/lets-workflow · .claude/skills/goal-test/SKILL.md · Local sandbox for experimenting with Claude Code's /goal command (stop-hook condition + LLM-evaluator driving…
git:20260525.c780b5a · audit A · 17 stars

Browse by kind, by grade A, or by owner.