Find docs and agent instructions in the carnival that no longer match the code, and file one GitHub issue per stale doc. Use when running the doc gardening maintenance loop, or when asked to check whether the README, AGENTS.md, a game's README or a skill is out of date. Files issues only; never changes code or docs.
80
100%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Docs drift when code changes and nobody updates them. Agents read these docs before they work, so a stale one leads them astray. Your job is to find the drift and file issues. Don't fix anything yourself: the factory ships the fixes.
Read each doc, then check every concrete claim it makes against the code:
README.md: commands, setup steps and the layout it describes.AGENTS.md: the layout, commands and house rules.src/games/<game-id>/README.md: how to play, scoring, options and
files. Check numbers (shot counts, speeds, points) and options (URL
parameters, keys) against the game's code.SKILL.md under skills/ and tessl-factory/skills/: file paths,
function names and steps.A claim is stale when the code does something different, or when it names a
file, function, option or command that doesn't exist. Run commands like
npm run check if you need to confirm one works.
Docs: <file> is out of date.src/games/water-cannon/game.ts:12. End with
a "Done when" saying the doc matches the code and npm run check passes.sjmaple/carnival
81e6f87
Also appears in
since Oct 24, 2026
since Oct 23, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.