illustrated-explainer-spec — Claude Code skill: install
The illustrated-explainer-spec Claude Code skill specifies a local web app that turns a topic into watercolor-style explanations and opens deeper views when users click the image.
no license 274 installs ★ 98 updated 2026-10-09
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a claude-codeWhat illustrated-explainer-spec does
This skill describes a single-page app for visual explanations. A user enters a subject, receives a 16:9 watercolor-like page, then clicks an area to request a deeper view of that part. The generated pages keep a shared visual treatment, while repeated topic and click inputs can reuse cached results.
The browser sends page requests to a server endpoint. The server derives stable IDs, checks files on disk, places a red marker over the selected parent image, and calls Google Gemini with text plus the image reference. The suggested Node.js setup uses Express, Sharp, @google/generative-ai, cors, and dotenv, with PNG output stored under the generated files directory.
The server needs GEMINI_API_KEY in .env. Without that key, the Google Gemini request cannot run.
What it helps with
- build a local image-based explainer app
- generate the opening page from a topic
- drill into a selected image area
- keep the illustration style across pages
- reuse results for repeated inputs
Example prompts for the agent
- Implement the illustrated explainer app with click-to-drill image pages.
- Build a local explainer where each image click opens a deeper watercolor page.
- Set up the project from the drill-down explainer specification.
How to install illustrated-explainer-spec
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a claude-code2Manually: put the files in place
~/.claude/skills/illustrated-explainer-spec/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/illustrated-explainer-spec/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a codex2Manually: put the files in place
.agents/skills/illustrated-explainer-spec/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a cursor2Manually: put the files in place
.cursor/skills/illustrated-explainer-spec/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills skills/illustrated-explainer-spec2Manually: put the files in place
.github/skills/illustrated-explainer-spec/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/illustrated-explainer-specManually: put the files in place
.devin/skills/illustrated-explainer-spec/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about illustrated-explainer-spec
How do I install illustrated-explainer-spec in Claude Code?
Run npx skills add reason-machines/trending-skills --skill illustrated-explainer-spec -a claude-code, then open ~/.claude/skills/illustrated-explainer-spec/SKILL.md.
What does illustrated-explainer-spec do?
It defines the structure of a local app that creates an illustrated explanation from a topic and produces a deeper page for the clicked area. Repeated requests can be served from a file cache.
What is required to run the app?
The suggested setup uses Node.js and Google Gemini. Add GEMINI_API_KEY to .env, then install the listed packages with npm install.