Hads

This teaches Claude to read and write HADS, a Markdown convention that separates facts from context using four block types: SPEC for authoritative data, NOTE for human explanation, BUG for known failures with fixes, and a question mark tag for unverified claims. The key trick is an AI manifest at the top of every document that tells models what to read and what to skip, which cuts token usage on large docs. Use it when you're writing technical documentation that AI will consume directly, or when you want to convert existing docs into something more parseable. The BUG block structure is genuinely useful even if you ignore the rest.

Install to Claude Code

npx -y skills add wshobson/agents --skill hads --agent claude-code