Skills
Personal Agent Skills I use across every project — turn a PR, a git ref, or a freeform idea into marketing briefs, blog posts, changelogs, social copy, newsletters, video scripts, rendered promo videos, architecture impact docs, technical presentation decks, and full courses.
Packaged as a Claude Code plugin, but the skills themselves are plain SKILL.md files with standard YAML frontmatter — the same format documented for Claude Code, GitHub Copilot CLI, OpenAI Codex CLI, Google Gemini CLI, and Cursor. Drop them in any of those tools' skills directories and they work. See Install.
Why this exists
I kept rewriting the same prompts: "summarize this PR for marketing", "draft the changelog", "write a launch tweet", "make me a 30s promo video". Every time, slightly different framing, slightly different quality. So I baked the expert versions of those prompts into reusable skills with strong opinions:
- Decision-maker framing. Architecture and marketing skills lead with the "so what?" — not what was refactored.
- Input pluralism. Every skill accepts a PR URL, a git ref range (
v1.0...v2.0), a file path, a marketing brief, an upstream blog post, or freeform text.
- Composability. The marketing skills feed each other: brief → blog post → social copy → newsletter, or run all of it via
/marketing-pipeline.
- No fluff. Skills enforce hooks, length limits, layout gates, and brand checks. The output is shippable, not "AI-generated".
The skills
| Skill | What it does |
|---|
| architecture-impact | Before/after architecture analysis for a PR with visual diagrams |
| marketing-brief | Structured marketing brief from a PR, ref range, or feature |
| changelog | Polished, Keep-a-Changelog-style release notes from git history |
| blog-post | Long-form blog posts with SEO, structure, and tone matching |
| newsletter | Product update emails with subject line + preview text |
| social-copy | Platform-specific copy (X, LinkedIn, etc.) tuned per algorithm |
| video-script | Timed, paced video scripts with visual directions |
| remotion-video | Rendered mp4 + poster via Remotion (React-based) |
| hyperframes-video | Rendered mp4 + poster via HyperFrames (HTML/GSAP-based) |
| marketing-pipeline | Orchestrate any combination of the above from one input |
| presentation | Research-grounded, craft-driven technical slide decks built on Slidev — live in the browser, zero manual steps |
| teach-me | Evidence-based course generator — markdown course + interactive HTML mini-course |
| epic-workshop | Epic Web / Epic React-style workshops, exercises, tips, and recordings |
| produce-video | Turn a raw recording into a finished, edited, annotated video + content package |
| transcribe-video | Transcribe video/audio to text with word-level timestamps (local Whisper) |
| youtube-copy | YouTube metadata — title, SEO description, tags, timestamped chapters |
| self-improve | Capture lessons/corrections and promote them into AGENTS.md or skills |
Why each one is cool
The "so what" engine for engineering leadership. Most PR descriptions are written by/for the author. This produces a doc you can hand to a PM or eng lead. Forces a TL;DR, before/after diagrams (one diagram = one question), business-impact framing, and an honest risk section. Passes the "newspaper test": if someone reads only the title, they understand why it matters.
How it works: reads PR diff + description, extracts the actual architectural delta (not just file changes), generates Mermaid diagrams for before/after, then writes the doc with progressive disclosure — TL;DR first, technical detail at the bottom.
A brief that a non-marketer can actually produce. Resolves any input (PR / ref range / path / freeform) into Executive Summary, Key Messages, Target Audience, Positioning, and Call to Action. It's the canonical source of truth that downstream skills (blog, social, newsletter, video) all key off — write it once, reuse everywhere.
Release notes that don't sound like commit messages. Walks git log over a ref range (or a single PR), categorizes Added/Fixed/Changed/Removed, and rewrites commit subjects into user-facing language. Optional gh release create. Smart enough to take a single #1234 and append it to an existing CHANGELOG.md version.
