devadvokit: Instructions file for Codex

DevAdvokit — Agent Guide

This repo contains AI agent skills for Developer Relations practitioners. Skills are installed via the npx skills CLI and run inside Claude Code or compatible agents.

---

What this is

DevAdvokit provides skills for DevRel practitioners:

• /setup-devadvokit — one-time setup that writes your professional context to ~/.devadvokit.md
• /generate-cfp — generates a complete conference proposal through a structured Q&A
• /generate-bio — generates a speaker or author bio with controls for length, person, and employer focus
• /build-talk-outline — turns a CFP submission into a timed outline with demo risk assessments and Patrick Winston principles applied throughout

All skills read ~/.devadvokit.md at runtime. If it's missing, they stop and redirect to /setup-devadvokit.

---

Repository structure

devadvokit/
├── skills/
│   ├── setup-devadvokit/
│   │   ├── SKILL.md
│   │   └── reference/
│   │       └── devadvokit-md-schema.md
│   ├── generate-cfp/
│   │   ├── SKILL.md
│   │   └── reference/
│   │       ├── cfp-evaluation-criteria.md
│   │       └── cfp-anti-patterns.md
│   ├── generate-bio/
│   │   ├── SKILL.md
│   │   └── reference/
│   │       └── bio-contexts.md
│   └── build-talk-outline/
│       ├── SKILL.md
│       └── reference/
│           ├── outline-structure-patterns.md
│           ├── demo-risk-patterns.md
│           └── winston-talk-principles.md
├── shared/
│   └── ai-antipatterns.md
├── AGENTS.md
├── README.md
├── LICENSE
└── .gitignore

No build step. The skills/ directory is the single source of truth and the install target. Edit files directly — what's in the repo is what gets installed.

---

Adding a new skill

1. Create skills/{name}/SKILL.md with the following frontmatter:

---
name: your-skill-name
description: One-sentence description of what the skill does.
---

Only name and description in frontmatter. Nothing else.

1. Add a reference/ subdirectory inside the skill folder if you need supporting documents. Reference files are copied alongside the skill on install.