human-review
Skill136 starsChanged 19 days agoMITView on GitHub
Prepare and guide human inspection of an Autoform roadmap or formalization through its Obsidian vault and rendered blueprint site. Use when a person wants to browse, approve, reject, or discuss scope, dependencies, progress, source links, or Lean artifacts visually; do not substitute an autonomous agent verdict for the human's judgment.
8 other projects use a version of this.
Adopted by
Most recently taken up by
- neeldas1209/GTM-Strategy-Enginetheir own version, first seen Oct 20, 2026
- yuhua99/skillstheir own version, first seen Oct 14, 2026
- jngme/claude-skillstheir own version, first seen Oct 13, 2026
- Plexito-de/honed-skillstheir own version, first seen Oct 11, 2026
- victorrentea/human-reviewtheir own version, first seen Sep 30, 2026
- petergyang/human-reviewtheir own version, first seen Aug 3, 2026
Other versions8 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 8
- petergyang/human-review★ 1.3ksame name
- victorrentea/human-review★ 43same name
- IrtezaAsadRizvi/claude-human-review★ 15same name
- Plexito-de/honed-skills★ 3same name
- yuhua99/skills★ 2same name
- arkan/skills★ 1same name
- jngme/claude-skills★ 0same name
- neeldas1209/GTM-Strategy-Engine★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository7 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agent-reviewSkill
- debrief-orchestratorSkill
- develop-pluginSkill
- formalizeSkill
- roadmapSkill
- setupSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 0 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 27
Stop on structural failures and present them before asking for mathematical judgment.
- Very specific: line 52
Treat the landing page's Fully proved percentage as the share of formalizable leaf targets that are fully proved, as the derived status …
- Very specific: line 90
Run review check; for each missing or stale card, prepare again and repeat steps 2 and 3.
- Very specific: line 103
Run review check again before reporting, and treat each finding as a failure.
“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Prepare a human review
Inspect the repository without changing mathematical content. Require an existing Autoform vault and site configuration; hand missing infrastructure to Setup. Keep the Markdown vault as the source of truth and regenerate only derived review views.
There is no autoform on PATH. Run it from <PROJECT> as
uv run --project "<AUTOFORM_PLUGIN_ROOT>" autoform, and autoform-visualize
the same way, where the root is the absolute plugin directory holding skills/
and pyproject.toml; give a subagent that prefix.
Regenerate the review views from <PROJECT> with the publication sequence in
the CLI reference,
but omit --require-declarations so the reviewer sees missing declarations.
Stop on structural failures and present them before asking for mathematical
judgment. For vault review, point the user to blueprint/README.md, coverage,
chapter pages, and the status and chapter summary in blueprint/dependencies.md
in Obsidian. For browser review, run
autoform dashboard <PROJECT> --site-dir site, which serves the deployed site
on loopback with local-only live claim badges, and give the overview plus the
relevant project, chapter, nested-scope, and statement-context links. Every
generated site page but the standalone dependencies/map/ page uses the same
viewer, the reader beside the project map; the old dependencies/ pages only
redirect to it. Drill from the project's topics to a
chapter, a nested scope, then a searched statement, in a window wider than
1,100 px so open details leave the hierarchy rail visible; on the map, one click
on a part shows the parts it builds on and the parts that use it.
Guide the review from coarse to fine: declared scope and exclusions, milestone
book, landing-page progress summary, cross-chapter graph, chapter graph, then
individual node and Lean-source links. Record each human decision as approve,
revise, or block, with the exact page or node and rationale. Separate
validator output from the person's judgment. Do not silently apply requested
revisions: hand mathematical-plan changes and Lean implementation changes to
Roadmap, which records the decision and retracts the affected article so
Formalize takes it up under the
revision contract,
and autonomous rubric scoring to Agent Review.
Treat the landing page's Fully proved percentage as the share of
formalizable leaf targets that are fully proved, as the
derived status
defines it, never as whole-source completion; read the declared source coverage
in its linked coverage contract before making scope claims. A target marked
mathlib: true follows the authored status contract; the marker is an author
assertion, not audit verification that the declaration is in Mathlib. A
statement-only target is incomplete, and so is a conditionally proved one,
whose proof rests on an open statement: present it as conditional, naming the
open statements in its Assumes row, never as proved or sorry-free.
Review formalized statements through blind read-backs
A read-back is a blind rendering in mathematical English of what one exact
Lean packet literally asserts. Use the review commands in the CLI
reference; review check is the one judge
of whether cards and approvals are current.
- Confirm that the repository has opted in with the
blueprint/.autoform-reviewpolicy marker, the lineautoform-review-policy/v1.autoform initnever writes it; if it is missing, ask the user before committing it, since it makes CI enforce statement review. Every Lean-mapped article needs durablearticle_idmetadata (see the article-ID migration check in the CLI reference) and must be a declaration-sized leaf, naming adeclaration:kind and containing no other articles; review commands refuse any other withreview-article-shape. Everyorigin: citedLean article must cite an exact line range in a local, non-Markdown source snapshot. Build the Lean project, prepare the blind packets, and keep their manifest with the coordinator. - Obtain a read-back for every packet that has none or whose card
review checkreports invalid. Never write one yourself. Launch an independent sub-agent in a fresh workspace containing only that packet, under its opaque hash filename, and the read-back reference. Do not give it the repository, article, source passage, packet manifest, or a revealing task description. Ask for testimony only. - Back in the coordinator's workspace, record the testimony through the CLI with the packet directory, the article ID, and the declaration. Never hand-author or repair a card's path, hashes, or frontmatter.
- Run
review check; for each missing or stale card, prepare again and repeat steps 2 and 3. Then render with--reviewand strict-build the site, which adds a Review disclosure under every formalized statement. - Walk the person through each statement: source and book text first, then the
read-back, then the exact packet. Ask whether the read-back says what the
book says, whether any hypothesis is missing or added, and whether the
definitions mean what the book's do. When they approve, copy the review hash
review checkprints for the article intoreview_approved. This edit is the person's assertion, not the agent's, but the hash only shows that nothing changed since it was written, and anyone can copy it. Commit the approval in a pull request into the default branch and ask a code owner of the article to approve it; a later push needs a new approval. When the person does not approve, recordrevisewith their reason and hand the change to Roadmap. - Run
review checkagain before reporting, and treat each finding as a failure. Every current approval is labelled self-approved, since nothing authenticates the hash: report a statement as approved by a person only when a code owner approved the pull request that committed itsreview_approved.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

