Skip to content

undeemed/walkthrough-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

walkthrough-kit

validate Claude Code plugin License: MIT

A Claude Code plugin that builds a spoken walkthrough kit for code you have to present inside an isolated IDE or grader sandbox (Litmus, CoderPad, HackerRank, a fresh cloud VM, a screen-share).

Born from recording real submission walkthroughs, where every polished asset died on arrival: the mermaid diagram that the grader's stripped VS Code cannot render, the demo command pointing at /Users/you/Dev/... that fails with MODULE_NOT_FOUND, the notation-heavy opening that sounds like reading a formula aloud.

The kit is one WALKTHROUGH.md you keep on a second monitor while recording.

What it produces

  • A plain-English opening (15-25s) with a pronunciation cheat for any notation
  • A file map table instead of an architecture diagram
  • Timed [SAY] / [OPEN] file:line -> symbol / [RUN] beats, 2-3 min total
  • One self-contained "money" demo (heredoc to /tmp, runs anywhere) showing correct-vs-broken
  • The real test command, sandbox-relative, with Node-version and busy-port fallbacks
  • An honest "what I'd change with another hour" answer tied to a named limitation

The hard rule behind all of it: code pointers + sandbox-portable commands. No diagrams, no local paths.

Install

As a plugin (recommended, gets updates):

/plugin marketplace add undeemed/walkthrough-kit
/plugin install walkthrough-kit@walkthrough-kit

Or as a standalone skill:

git clone --depth 1 https://github.com/undeemed/walkthrough-kit /tmp/wk && cp -r /tmp/wk/skills/walkthrough-kit ~/.claude/skills/walkthrough-kit

Use

Ask naturally right before you record:

I need to record a video walkthrough of my submission

Triggers on "video walkthrough", "record my submission", "walk through my code", "demo script", "talk track", "explain this on camera".

Structure

.claude-plugin/
  plugin.json               plugin manifest
  marketplace.json          lets `/plugin marketplace add undeemed/walkthrough-kit` work
skills/
  walkthrough-kit/SKILL.md  the walkthrough-kit generator (only skill for now)

Skills under skills/ are auto-discovered by the plugin. To add one, create skills/<name>/SKILL.md with name and description frontmatter - nothing to register. Agents (agents/*.md), commands (commands/*.md), and hooks (declared in plugin.json) slot in the same way when needed.

Contributing

Portability recipes for more sandboxes and languages welcome - see CONTRIBUTING.md.

Star history

Star History Chart

License

MIT

About

Claude Code plugin: spoken walkthrough kits for code demos inside isolated grader sandboxes. Code pointers + portable commands, no diagrams, no local paths.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors