=============== LIBRARY RULES =============== From library maintainers: - Install the skill with: npx skills add abuzarhamza/show-me-k --skill show-me-mr - Invoke it as /show-me-mr [PR/MR number | URL | branch] [text|diagram|html|video] [--post] - The skill writes outputs to .show-me/mr-{id}/ (explainer.md, index.html, explainer.mp4); add .show-me/ to .gitignore - Use gh for GitHub and glab for GitLab; without either, the skill diffs the local branch against the default branch - The skill never pushes, merges, approves, or edits the PR/MR description, and it asks before posting a comment or calling ElevenLabs ### Install with npx Source: https://github.com/abuzarhamza/show-me-k/blob/main/README.md Install the show-me-mr skill using npx. ```bash npx skills add abuzarhamza/show-me-k --skill show-me-mr ``` -------------------------------- ### Install as Claude Code plugin Source: https://github.com/abuzarhamza/show-me-k/blob/main/README.md Add the marketplace and install the plugin via Claude Code commands. ```text /plugin marketplace add abuzarhamza/show-me-k /plugin install show-me-mr@show-me-k ``` -------------------------------- ### Check tools for Manim, ffmpeg, ElevenLabs, and local TTS Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/video-explainer.md Run these checks to verify required tools and environment variables. Report findings in one line. Manim Community Edition is needed for animation; if missing, ask user before installing. ElevenLabs requires ELEVENLABS_API_KEY and user consent. ```bash command -v manim ffmpeg ffprobe python3 -c "import manim" 2>/dev/null && echo manim-py-ok [ -n "$ELEVENLABS_API_KEY" ] && echo elevenlabs-key-set command -v say piper 2>/dev/null ``` -------------------------------- ### Open HTML explainer (Linux) Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/SKILL.md Command to open the generated HTML explainer on Linux. ```bash Bash(xdg-open .show-me/mr-{id}/index.html) # Linux ``` -------------------------------- ### Render Manim scenes and combine with audio to produce final video Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/video-explainer.md Render each Manim scene at draft quality, combine each with its audio, then concatenate all parts into the final explainer.mp4. Use -qh only if user asks. If a render fails, fix and re-render only that scene. ```bash manim -qm scenes.py Scene1 Scene2 ... # draft quality; use -qh only if the user asks # Combine each scene with its audio, then concatenate the scenes ffmpeg -i media/videos/scenes/720p30/Scene{n}.mp4 -i audio/scene{n}.* -c:v copy -c:a aac -shortest part{n}.mp4 printf "file 'part%s.mp4'\n" 1 2 3 ... > parts.txt ffmpeg -f concat -safe 0 -i parts.txt -c copy ../explainer.mp4 ``` -------------------------------- ### Open HTML explainer (macOS) Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/SKILL.md Command to open the generated HTML explainer on macOS. ```bash Bash(open .show-me/mr-{id}/index.html) # macOS ``` -------------------------------- ### Generate audio per scene with ElevenLabs or macOS say, then measure duration Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/video-explainer.md Generate one audio file per scene using either ElevenLabs (with consent) or macOS 'say'. Then measure duration with ffprobe. ElevenLabs is a paid API that receives script text; only use with user agreement. ```bash # ElevenLabs (only with consent) curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/${ELEVENLABS_VOICE_ID:-21m00Tcm4TlvDq8ikWAM}" \ -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \ -d "$(jq -n --arg t "$TEXT" '{text:$t, model_id:"eleven_multilingual_v2"}')" \ -o audio/scene{n}.mp3 # macOS local say -o audio/scene{n}.aiff "$TEXT" # Duration in seconds ffprobe -v error -show_entries format=duration -of csv=p=0 audio/scene{n}.* ``` -------------------------------- ### show-me-mr command usage Source: https://github.com/abuzarhamza/show-me-k/blob/main/README.md Invoke the skill with various options: current branch, PR/MR number, output level, and posting as comment. ```text /show-me-mr # current branch, up to HTML /show-me-mr 142 # PR/MR #142 /show-me-mr 142 diagram # text and diagrams only /show-me-mr 142 video # all four levels /show-me-mr 142 --post # also post explainer.md as a PR/MR comment (asks first) ``` -------------------------------- ### Final answer file list Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/SKILL.md Template for the final answer listing the generated files and posted comment URL. ```markdown - Markdown: `.show-me/mr-{id}/explainer.md` - Explainer: `.show-me/mr-{id}/index.html` (only if made) - Video: `.show-me/mr-{id}/explainer.mp4` (only if made) - Posted: {comment URL} (only if posted) ``` -------------------------------- ### Markdown explainer template Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/SKILL.md Template for the level 1 text explainer. Fill in the sections with STE-style writing and review order. ```markdown ## What this change does {1 to 3 STE sentences.} ## Why {1 STE sentence.} ## Read this first - {1 to 3 warnings: migrations, breaking changes, feature flags, deliberate omissions, surprising decisions. Write "None." if there are none.} ## Review order 1. `{path}`: {what to check in this file, one sentence} ``` -------------------------------- ### Logic as pseudocode - diff Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Shows pseudocode for a reconnect handler, replacing a full fetch with reading a saved cursor, replaying events, and resuming a live stream. Use to illustrate the new logic flow. ```diff on(reconnect) - fetch all sessions + read saved cursor + replay events after cursor + resume live stream ``` -------------------------------- ### Call tree - diff Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Shows a call tree for openSession, replacing startPolling with subscribe(stream) and its event handlers. Use to show the call hierarchy and the new subscription flow. ```diff openSession loadSession - startPolling + subscribe(stream) + onEvent → store.apply + onDrop → replay(cursor) ``` -------------------------------- ### UI component tree - diff Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Shows a component tree for SessionPage, adding a ReconnectBanner component. Use to highlight component structure, hooks, and package boundaries. ```diff (apps/web/src/routes/session.tsx) useSessionEvents() + (packages/ui) ``` -------------------------------- ### File responsibility - diff Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Shows a shallow directory tree with comments indicating responsibilities, marking changes to session files. Use to communicate which files own which responsibilities without listing every file. ```diff src/sessions/ ├── store.ts # owns session state -├── poller.ts # polled the API every 2s +├── stream.ts # subscribes to EventStream +└── replay.ts # replays events from cursor on reconnect ``` -------------------------------- ### Interaction across components: Mermaid sequence diagram Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Mermaid sequence diagram showing message order between Client, API, and EventStream during a reconnect. Use when the order of messages is the point. ```mermaid sequenceDiagram participant Client participant API participant EventStream Client->>API: reconnect(cursor=41) API->>EventStream: read from 42 EventStream-->>Client: events 42..57 EventStream-->>Client: live events ``` -------------------------------- ### Contract: API, schema, types - diff Source: https://github.com/abuzarhamza/show-me-k/blob/main/plugins/show-me-mr/skills/show-me-mr/references/views.md Shows a diff of a TypeScript type definition for a Session, adding a cursor field and removing lastPolledAt. Use to highlight the changed data shape with only the fields that matter. ```diff type Session = { id: string userId: string + cursor: number # last event the client saw - lastPolledAt: Date } ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.