No work step here. This is probably a skill that reads or coordinates, not one that produces something.
.md file to compare - side-by-side diff against contract-test
contract-test
description: "Triggers on prompt mention of 'contract-test'."
What it does for you
Checks that connected services still behave the way your work expects.
What it produces
A recent result, so you can see the kind of work it returns.
loading…
How to get it
These run inside the Snappy workspace. Want this working in your business? I set skills like this up with you, in one focused week.
For developers how this skill is built, graded, and how it runs
at a glance- the short version
what's inside - the parts that make up a skill 2/4 present
A skill is just a few plain-text files. Only the main one is required. The rest are optional, added as the work needs them. This is what the skill is made of; how it runs is just below.
state/skills/contract-test/SKILL.md
present
state/lib/contract-test.ts
not present
state/bin/contract-test/
not present
state/skills/contract-test/AGENTS.md
present
how it's graded - what counts as a good run 3 criteria · 1 deterministic · 2 judge
Each row is one thing a good run has to get right. deterministic means a quick check decides, pass or fail. judge means the AI reads the result and rates it. Grading each piece on its own (instead of one overall score) shows exactly where a run fell short, so the fix is obvious.
how it runs - the shared frame every skill uses 4/5 present
Every skill runs the same way. One part does the work, a separate part checks it, and a short loader hands the AI exactly what it needs for the job. Anything this skill doesn't use shows a one-line note saying why, on purpose, not by accident.
state/log/evals.ndjson - NEVER treat a dormant skill as runnable without reviving its spec
- ALWAYS prefer an existing active skill over resurrecting a dormant one
what it has learned - fixes written back in over time sample
When a run hits something this skill didn't handle, the fix gets written back into the skill so it doesn't happen again. FIXED means it was corrected on the spot. LOGGED means it's queued for a bigger rewrite. Either way, the skill gets a little better and never makes the same mistake twice.
- Loading feedback rows…
how the work flows- step by step
SKILL.md- the skill, written out in plain English
contract-test
Reclaimed by state/bin/orphan-audit/fix.ts on 2026-04-18. Historical eval rows exist under this name (count at reclaim: 336) but no prose doc was on disk. This stub gives those rows a catalog home so lint stops flagging them as ghosts.
Eval
Dormant. No new runs expected.
Rubric
criteria:
- name: skill_is_dormant
kind: deterministic
check: "The 'graduation' field in SKILL.md is set to 'dormant'."
- name: description_mentions_reclamation
kind: judge
check: "The skill's description clearly states it was reclaimed and is a stub for historical eval rows."
- name: no_new_runs_expected
kind: judge
check: "The eval section explicitly states 'No new runs expected'."AGENTS.md- what the AI loads when this skill comes up
contract-test - loader (dormant)
Full reference: state/skills/contract-test/SKILL.md. This skill is dormant; new runs are not expected.
Critical Rules
- NEVER treat a dormant skill as runnable without reviving its spec
- ALWAYS prefer an existing active skill over resurrecting a dormant one
Commands
| ui dashboard | state/skills/contract-test/resources/ui.openui | |full spec: state/skills/contract-test/SKILL.md |eval log: state/log/evals.ndjson (skill: "contract-test" - historical only)
OpenUI Resource
- Skill-owned OpenUI Lang resource:
state/skills/contract-test/resources/ui.openui. Read it before rendering or editing this skill's generated component surface. - Treat this resource as a first-class artifact of the skill, not a generic chat response. Improve it when the skill's user-facing output needs to become richer.
- System resources compose OpenUI primitives and inherit SnappyChat tokens. Use
ui_contract: brandedin SKILL.md only for deliberate platform or client visuals.
Known Pitfalls
_(reclaimed ghost - no failures recorded in the new catalog yet.)_
Self-Test
- [ ] Is this skill truly needed, or should I use an active neighbor?
<!-- kernel-ok: historical attribution for the PID-loader pattern. -->
Self-correcting loader (PID feedback)
This is the rule that makes loaders learn. Ported from snappy-kernel, where it demonstrably worked: the snappy-dom-cartographer skill mapped Skool admin UI once, every later ship-agent inherited the full map for free.
Before you finish, do two things:
1. Fix gaps (P - proportional). MANDATORY. If this loader didn't cover your case - if you had to read another file, run an undocumented command, work around a wrong selector, or discover a quirk - you MUST attempt an Edit to this AGENTS.md before you log.
- Default action: edit this file. Surgical. Add the missing line, table
row, or code example where it belongs. No restructuring.
- Only
LOGGEDis allowed when: the fix needs >10 lines, spans multiple
files, or requires a structural rewrite. In that case the state/regen/drain.sh queue picks it up asynchronously.
- "I didn't have time" / "it's minor" / "the next agent will figure it out"
are NOT valid reasons. Minor gaps compound - that's the whole point of this loop.
- Concrete example of a valid P-fix: discover
agent-browser screenshot
takes path positionally not as --output <path>. One line in a table. Edit it in. Do not just log it.
- The goal: the next agent never has to leave the loader.
2. Log the result.
echo "[$(date -u +%FT%TZ)] contract-test: <what was missing or fixed> [FIXED|LOGGED]" >> state/log/loader-feedback.log
FIXED= you patched this loader inline (P-fix).LOGGED= too large for inline; the PostToolUse enqueue + Stop-hook drain
will rewrite the loader from scratch on next session-end.
Do not skip this. Every agent run must leave the system better than it found it. The loader is the setpoint; you are the sensor; the gap is the error signal; closing the gap is the correction.
api.ts- the code it can call
⚠ no api.ts - this skill has no typed action surface
scripts- helper scripts it can run
prose-only skill - 1 inline code block live in SKILL.md above (no state/bin/ sidecar yet).
how we check it- the checks, plus the last 10 runs
| timestamp | verb | score | primary_issue | artifact |
|---|---|---|---|---|
| 2026-04-21 15:58Z | - | 1.00 | - | - |
| 2026-04-21 15:56Z | - | 1.00 | - | - |
| 2026-04-21 03:53Z | - | 1.00 | - | - |
| 2026-04-20 01:47Z | - | 0.00 | - | - |
| 2026-04-20 01:47Z | - | 0.75 | - | - |
| 2026-04-20 01:47Z | - | 0.75 | - | - |
| 2026-04-20 01:44Z | - | 0.00 | - | - |
| 2026-04-20 01:44Z | - | 0.75 | - | - |
| 2026-04-20 01:44Z | - | 0.75 | - | - |
| 2026-04-20 01:42Z | - | 0.00 | - | - |