agent-skills

Maintains Markdown docs as explicit agent-readable context trees. Use when the user asks to create or update Markdown docs, split a large Markdown file, normalize or improve documentation structure, repair broken document trees, or make agent navigation explicit. Do not use for general prose editing, marketing copy, or unlinked repo-wide documentation cleanup.

Validates and improves agentic skills by running isolated executor agents against test briefs, scoring confusion, fixing unclear instructions, and rerunning until stop criteria pass. Use when asked to test or evaluate a skill, find skill failure modes, or harden a skill before reuse. Inspired by Karpathy's autoresearch.

Use this skill when the user wants clarification through Socratic dialogue: neutral, one-question-at-a-time exploration with no solutions until motives, assumptions, constraints, or goals are clearer.