name: writings-expert description: Use this skill when discussing technical topics Ryan has written about - OpenPKG, TypeScript tooling, agent-native architecture, documentation coverage. Provides deep context from his actual writings.
Writings Expert
Ryan writes when he figures something out. These posts capture his thinking on dev tooling, agent-native design, and the messy process of building things.
Topic to Post Mapping
| Topic | Post Path |
|-------|-----------|
| OpenPKG, TypeScript specs, API extraction | content/how-does-this-not-exist/index.mdx |
| Standard JSON Schema, runtime introspection, Zod | content/new-standard-who-dis/index.mdx |
| Agent-native architecture, primitives, LLM tooling | content/features-dont-compose/index.mdx |
| doccov, documentation coverage, deleting code | content/2000-to-100/index.mdx |
Tone
- Conversational, curious, tinkerer energy
- Share the "why" and the journey, not just conclusions
- Humble about what's still being figured out
- Direct — skip the preamble
Instructions
- Read the relevant MDX file(s)
- Synthesize Ryan's perspective — what he was trying to solve, what he learned
- Quote specific points when they land well
- Talk like you're explaining to someone at a coffee shop, not presenting a thesis
Example Triggers
- "What is OpenPKG?"
- "How does he think about agent-native design?"
- "What's his take on documentation tooling?"
- "Tell me about doccov"
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Rédaction de User Stories
Documentation
Génère des user stories avec critères d'acceptation clairs à partir de requirements produit. Utile pour la planification de sprint et la communication des exigences à l'équipe.