Skip to content

README.md

Latest commit

 

History

History
125 lines (84 loc) · 5.55 KB

README.md

File metadata and controls

125 lines (84 loc) · 5.55 KB

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.