tomthebearded

tomthebearded/guide-forge

Plugin Claude Code

Plugin marketplace listing 1 plugin: guide-forge.

tomthebearded/guide-forge

Plugin Claude Code

Turn any idea — or an existing tutorial — into a step-by-step build guide that teaches while it builds. A gated pipeline of skills that plan, draft, clarify, review, modernize, audit, scaffold, version-update, and check-your-work-against learn-as-you-go developer guides.

tomthebearded/guide-forge

Skill Claude CodeCodex

The requirements changed while someone is halfway through a learn-as-you-go guide — fold the change in WITHOUT rewriting the work they've already executed. Reads foundation/progress.md to find the frontier (and stops to have it confirmed if it's missing or stale), verifies any new fact online, then delivers an impact…

tomthebearded/guide-forge

Skill Claude CodeCodex

Lint/QA a drafted learn-as-you-go guide against the GuideForge contract and report violations, ranked by severity — structural (missing Done-when, no nav line, partial code, dead links, no overview) and pedagogy (undefined terms, missing WHERE/WHY, arrow-chains, vague values, a solved capability hand-rolled without…

tomthebearded/guide-forge

Skill Claude CodeCodex

Reconcile the REAL project against the learn-as-you-go guide you have been following — does what you built actually contain what the steps you executed told you to write? Reads the milestone checkpoints (the complete-file sections of each NNverify.md), diffs them against your files while ignoring cosmetic differences…

tomthebearded/guide-forge

Skill Claude CodeCodex

Run the pedagogy pass over ONE existing step of a learn-as-you-go guide to remove confusion — without changing what the step does. Use when a step reads unclearly, a reader got stuck, or a term went undefined. Invoke with the step to clarify, e.g. "/clarify-step 03first-route.md".

tomthebearded/guide-forge

Skill Claude CodeCodex

Draft an approved learn-as-you-go build guide into folders of atomic, teaching step files — the WHOLE guide by default (every milestone, in one pass), or a single named milestone if one is given (for re-drafts/fixes). Use after a plan from the plan-guide skill has been approved. Invoke with no argument to draft the…

tomthebearded/guide-forge

Skill Claude CodeCodex

A reader hit friction while following a learn-as-you-go guide — capture it to the guide's feedback log WITHOUT changing the guide. Appends one dated, structured entry (where · reader · what happened · suspected class · severity · tags · quote) to guide/feedback-log.md, so friction becomes durable data for improving…

tomthebearded/guide-forge

Skill Claude CodeCodex

Record what you have actually EXECUTED while following a learn-as-you-go guide — step by step — into the guide's foundation/progress.md ledger, and reconcile foundation/status.md (frontier, milestone table, session log) with it. Marks only: it never edits step files, never fixes anything, and never marks a milestone ✅…

tomthebearded/guide-forge

Skill Claude CodeCodex

Restructure an EXISTING flat tutorial / README / runbook / legacy guide into a learn-as-you-go GuideForge plan: reverse-engineer its implicit ladder, diagnose it against the pedagogy principles, verify its (likely stale) stack online, and re-cast it as a plan with a source-map. Use when the user has an existing…

tomthebearded/guide-forge

Skill Claude CodeCodex

Plan a learn-as-you-go, step-by-step developer build guide from a one-line idea. Use when the user wants to create a tutorial, course, onboarding doc, or build guide that TEACHES while it builds — for any domain (games, libraries, web, CLIs, APIs). Runs an audience interview, then produces a milestone-laddered plan …

tomthebearded/guide-forge

Skill Claude CodeCodex

Pre-flight a contribution to the GuideForge repo before opening a PR — verify every CONTRIBUTING ground rule and PR-checklist item is respected, and that the repo is internally consistent (skill frontmatter valid, README/EXPLAINER skill list in sync, CHANGELOG updated, version stamps aligned, no dead links).…

tomthebearded/guide-forge

Skill Claude CodeCodex

A reader hit a real issue while following a learn-as-you-go guide — report it and fix the guide so the issue can't recur. Diagnoses the root cause, fixes the step where they got stuck, then sweeps the WHOLE guide for every other place the same class of defect appears and fixes those too, adds a failure-note guard…

tomthebearded/guide-forge

Skill Claude CodeCodex

Reconcile a learn-as-you-go guide (or one step) against reality BEFORE you execute it — catch stale APIs, moved files, renamed UI, missing prerequisites. Use right before acting on a guide written a while ago, or against a codebase/tool that may have moved. Invoke with the step to review, e.g. "/review-before-follow…

tomthebearded/guide-forge

Skill Claude CodeCodex

Stamp the folder skeleton + six foundation docs (stack, status, progress, glossary, conventions, decision-log) of a GuideForge guide from an approved plan, pre-filled from the plan and with a placeholder overview per milestone — so drafting can start immediately. Use after a plan is approved and before drafting the…

tomthebearded/guide-forge

Skill Claude CodeCodex

Re-verify a guide's framework/library versions online and bring the guide up to date. Re-checks each tool's latest stable version, rewrites stack.md, then scans the guide and rewrites ONLY the steps whose code/commands/APIs/doc-links the bump affects (using the new version's features), logs the drift in status.md +…