hads

Convert Markdown documentation into HADS-compliant [SPEC], [NOTE], and [BUG] blocks.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/haxlys/skills --skill hads-haxlys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hads
Source: https://github.com/haxlys/skills/tree/main/vendored/wshobson-agents/plugins/documentation-standards/skills/hads
Command: npx skills add https://github.com/haxlys/skills --skill hads-haxlys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HADS enables writers and AI systems to exchange technical documentation by separating authoritative facts ([SPEC]), human context ([NOTE]), and verified issues ([BUG]), improving both human readability and machine interpretability.

Core Features & Use Cases

  • Convert existing Markdown into HADS blocks to standardize documentation workflows.
  • Validate and enforce structure (version banner, AI manifest, and bolded blocks) for reliable AI processing.
  • Use cases include migrating docs for AI-assisted review, enabling safer agent interactions, and maintaining audit trails of changes.

Quick Start

Convert a sample document to HADS by replacing factual statements with [SPEC] blocks, moving narrative to [NOTE], and surfacing known issues as [BUG].

Frequently Asked Questions about hads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown documentation into AI-readable blocks?

Converting Markdown into AI-readable blocks involves separating authoritative facts, human context, and verified issues into structured [SPEC], [NOTE], and [BUG] formats. This standardization ensures reliable machine interpretation and safer agent interactions.

What is the best way to structure technical docs for AI-assisted review?

The best way to structure technical docs for AI-assisted review is enforcing a standardized manifest with version banners and bolded blocks. Separating factual specifications from narrative notes improves both human readability and machine processing reliability.

Why does my AI agent struggle to parse standard Markdown documentation?

AI agents struggle to parse standard Markdown because unstructured text mixes facts with context, reducing reliability. Applying a structured AI manifest with designated [SPEC], [NOTE], and [BUG] blocks separates authoritative data from narrative for safe consumption.

Can I validate existing Markdown docs for AI-safe consumption?

Yes, you can validate existing Markdown docs for AI-safe consumption by enforcing structural rules like version banners and bolded blocks. This process checks and standardizes documentation workflows to ensure reliable AI processing.

When do I need to separate facts, context, and issues in technical documentation?

You need to separate facts, context, and issues when migrating docs for AI-assisted review or enabling safer agent interactions. Structuring content into [SPEC], [NOTE], and [BUG] blocks maintains audit trails and improves machine interpretability.

Are there limitations to using unstructured Markdown for AI agent interactions?

Unstructured Markdown limits AI agent reliability by blending factual statements with narrative context. Separating content into standardized [SPEC], [NOTE], and [BUG] blocks overcomes this constraint, ensuring accurate data extraction and safer processing.