clarify-step

A guide for rewriting one existing step in a learn-as-you-go tutorial so its wording is easier to understand without changing the step's task.

In plain words
What is it for?
It is for clarifying a named guide step in place, checking whether it has already been executed, and reporting the edits made.
Why use it?
It addresses unclear instructions, undefined terms, or places where a reader got stuck while preserving the original behaviour.

Skill for Claude CodeCodex

Part of the guide-forge plugin — 14 skills shipped together

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/clarify-step
Any agent
npx skills add tomthebearded/guide-forge --skill clarify-step
Clone the repo
git clone --depth 1 https://github.com/tomthebearded/guide-forge

Made for: Claude Code, Codex.

Or install guide-forge, the plugin that ships this one along with the rest of its 14 skills.

Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 424 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.00070 $0.00424
Opus 5 $0.00035 $0.00212
Sonnet 5 $0.00014 $0.00085
Haiku 4.5 $0.00007 $0.00042

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

Security

Grade A, and why

clarify-step 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 3d 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/clarify-step/SKILL.md · 37 lines

What it actually says

Skill: clarify-step

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 step to clarify is $ARGUMENTS below (plus any attached code files the step references).
  • You have file tools here — edit the step in place on disk rather than only printing the revised version, then give the change list.
  • Where the prompt hands off to another prompt by filename, use the sibling skill of the same name (/review-before-follow).

Step to clarify:

$ARGUMENTS

Gate: clarity only — never change what the step does. Run the prompt's Step 0 frontier check and say in one line whether the step is already executed; if the pass turns out to need a load-bearing edit (a rename, a changed value, a re-cut step, a gate that would assert something new) on an executed step, stop and let the user choose rather than applying it. If you spot a genuine bug, flag it, don't silently fix it.

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. 3d ago First seen · 37 lines · 70 tokens per session scan A 0fecb9564540

Subscribe to this mod's changes

clarify-step is a skill published in the GitHub repository tomthebearded/guide-forge (3 stars, last pushed 12d ago), licensed MIT. It adds 70 tokens to every session and 424 once invoked, about $0.0003 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