audit-guide

A quality-checking guide for learning-oriented software guides. It checks whether a guide follows the GuideForge rules for structure, navigation, links, explanations, and teaching steps.

In plain words
What is it for?
Use it to review a guide, milestone, or set of steps and receive a read-only report of problems ranked by severity.
Why use it?
It finds missing explanations, incomplete code, dead links, vague instructions, and other problems before a guide is published.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tomthebearded/guide-forge/audit-guide
Any agent
npx skills add tomthebearded/guide-forge --skill audit-guide
Clone the repo
git clone --depth 1 https://github.com/tomthebearded/guide-forge

Made for: Claude Code, Codex.

Per session 128 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 413 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00128 $0.00413
Opus 5 $0.00064 $0.00206
Sonnet 5 $0.00026 $0.00083
Haiku 4.5 $0.00013 $0.00041

Measured 2d ago against content hash 4cacb072fe98, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

audit-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/audit-guide/SKILL.md · 36 lines

What it actually says

Skill: audit-guide

The complete, canonical contract for this skill is the paste-prompt it wraps, inlined here — follow it in full:

!cat "${CLAUDE_SKILL_DIR}/prompt.md"

(If the block above came back empty or errored, read prompt.md in this skill folder — it sits beside this SKILL.md — and follow that.)

As you follow it, adapt for the fact that you're a Claude Code skill, not a pasted prompt:

  • You're already invoked — skip its "How to use / paste this" preamble. The guide, milestone, or steps to audit are $ARGUMENTS below (plus any attached files). Read the target files yourself where you can.
  • Read-only — produce the findings report as your reply; never edit the guide.
  • Where the prompt points at another prompt by filename, use the sibling skill of the same name (/clarify-step, /review-before-follow).

Guide to audit:

$ARGUMENTS

Gate: flag, don't fix — point the user at /clarify-step for the pedagogy issues you find.

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 36 lines · 128 tokens per session scan A 4cacb072fe98

Subscribe to this mod's changes

audit-guide is a skill published in the GitHub repository tomthebearded/guide-forge (3 stars, last pushed 12d ago), licensed MIT. It adds 128 tokens to every session and 413 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

shadow-tutor

Post-session programming tutor for a developer who wants to grow. Use after an AI-assisted coding session to learn from it — it picks the one load-bearing decision the AI made that you most likely don't truly understand, makes you predict why before it reveals (breaking the "I get it" illusion), teaches the why…

lzfxxx/shadow-tutor · 118 tokens

codetrain

Use when the user wants to be taught/walked through code one tiny step at a time — triggers like "teach me this code", "walk me through this", "hold my hand", "explain step by step", "tutor me", "guide me through", "I want to learn this", or asks for a safe practice exercise to learn a concept.

InferHaven/agent-skills · 78 tokens

learning-tutor

Use when a developer wants to learn about the codebase, start a learning session, understand how something works, or progress through the curriculum. Activates when the intent is learning rather than doing. Trigger phrases: "I'm new here", "walk me through", "help me understand", "start a learning session", "what…

psreek-ai/codebase-mooc · 111 tokens

curriculum-reviewer

Use when reviewing AI-generated curriculum content in the human review queue. Activates when working through .codebase-mooc/memory/humanreviewqueue.jsonl or when asked to review, approve, or assess generated curriculum content. Trigger phrases: "review the curriculum", "check the review queue", "approve this content"…

psreek-ai/codebase-mooc · 82 tokens

trulens-notebook-execution

Execute and display Jupyter notebooks for TruLens demos and quickstarts.

truera/trulens · 21 tokens

eli5

Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.

companion-inc/feynman · 63 tokens