DevAdvokit

AI agent skills for Developer Relations practitioners. Set up your context once, then generate conference proposals and speaker bios on demand.

---

Skills

/setup-devadvokit

One-time setup. Runs an interactive Q&A and writes your professional context — current role, background, audience, content voice, and a library of past work — to ~/.devadvokit.md. All other DevAdvokit skills read this file automatically.

/generate-cfp

Generates a complete conference proposal through a structured brainstorming Q&A. Produces:

• Abstract (100–150 words)
• Extended abstract (200–300 words)
• 3 title variants
• 3–5 learning outcomes
• A content library check for overlap with past work

Output is calibrated to the session format and grounded in your speaker context from ~/.devadvokit.md.

/build-talk-outline

Turns a CFP abstract or talk description into a fully structured outline with section timings. Produces:

• Timed outline using the right structural pattern for the talk type
• Patrick Winston principles applied throughout: empowerment promise opening, contributions close, the Winston Star (slogan, surprise, salient idea, symbol), vision/proof structure for persuasive talks, slide density check
• Per-demo risk blocks with dependencies, failure modes, fallback plans, and prep checklists
• Consolidated risk summary with critical path, time risk, and a concrete contingency plan

/generate-bio

Generates a speaker or author bio through a short Q&A. Controls for:

• Format — conference profile, LinkedIn, team page, podcast intro, personal site, and more
• Length — one-liner through long-form, or a specific word/character count
• Person — first or third
• Employer focus — a 1–5 scale from employer-led to employer-light

At scale 1, the bio opens with your company and frames everything through your current role. At scale 5, your current employer is mentioned but not foregrounded — the bio leads with career-wide expertise and holds up regardless of where you work.

/repurpose-talk

Converts a delivered talk into multiple content pieces for broader reach. Produces:

• Blog post outline (H2 structure with section notes)
• 5 LinkedIn post angles (different hook strategies)
• 3 tweet thread starters
• Newsletter section (150–200 words)
• Cold pitch paragraph for third-party publication

Works with just an abstract, or with full transcript/notes for more grounded outputs. Pulls quotable lines, flags demo content that won't translate to text, and notes claims needing source links. Checks content library for overlap with past work.

/find-content-angles

Takes a single content piece and extracts multiple angles from it. Produces:

• Abstraction ladder — specific problem solved, then 3 levels of generalization up to universal principle
• Audience pivots — same insight reframed for different readers
• Controversy check — surfaces defensible contrarian takes buried in your content
• "What this assumes" — hidden assumptions that could each become their own piece

Finds the seeds of future content in work you've already published.

/find-series-opportunities

Analyzes your content library to find series patterns. Produces:

• Thematic clusters — content grouped by underlying theme, not surface topic
• Repeated points — where you made the same point from different angles without realizing it
• Incomplete arcs — wrote parts 1 and 3 but part 2 is missing
• Series framing — title and premise that makes relationships between pieces explicit

Connects across your existing work rather than analyzing a single piece.

/turn-incident-into-content

Converts user problems and support interactions into shareable content. Produces:

• TIL format — short-form version for posts, threads, newsletters
• Full context format — longer framework for blog posts or deep-dives
• Format recommendation — whether this belongs in docs, blog, or talk

Separates the tactical fix from the transferable lesson.

---

Installation

npx skills add phazonoverload/devadvokit

Install a specific skill only:

npx skills add phazonoverload/devadvokit --skill generate-cfp

Update after repo changes:

npx skills update

---

Quick start

1. Run /setup-devadvokit once. This creates ~/.devadvokit.md with your DevRel context.
2. Run /generate-cfp whenever you need a conference proposal.
3. Run /build-talk-outline to turn a CFP into a structured, timed outline.
4. Run /generate-bio whenever you need a speaker or author bio.
5. Run /repurpose-talk after delivering a talk to generate blog outlines, social posts, and newsletter sections.
6. Run /find-content-angles to extract multiple angles from a single content piece.
7. Run /find-series-opportunities to discover series patterns across your content library.
8. Run /turn-incident-into-content to convert user problems into shareable content.

All skills read your context automatically — no re-entering your details each time.

---

About ~/.devadvokit.md

A plain Markdown file in your home directory. Contains your professional identity, location, specialist areas, primary audience, content voice, hobbies and interests, and a table of past talks and writing. Written and maintained by /setup-devadvokit.

The file is never overwritten without confirmation. On repeat runs, the setup skill offers to update individual sections or append new content to the library.

.devadvokit.md is in .gitignore — it won't be committed if you clone this repo into your home directory.