documentation-standards

v1.0.1

HADS (Human-AI Document Standard) — semantic tagging convention for writing documentation that works efficiently for both human readers and AI models. Reduces token consumption and hallucination risk by separating machine-critical facts from human context.

CodexClaude Code1 skill

by Niksa BarlovicMIT38.6kupdated 4 days ago

Source

$ git clone https://github.com/wshobson/agents

Clone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is plugins/documentation-standards/ inside the repository.

Layout

plugins/documentation-standards/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── skills/hads/SKILL.md

Skills1

hadsskills/hads/SKILL.md

Use when writing technical documentation that needs to be readable by both humans and AI models, converting existing docs to HADS format, validating a HADS document, or optimizing documentation for token-efficient AI consumption.

Manifests2

plugins/documentation-standards/.codex-plugin/plugin.json

{
  "name": "documentation-standards",
  "version": "1.0.1",
  "description": "HADS (Human-AI Document Standard) — semantic tagging convention for writing documentation that works efficiently for both human readers and AI models. Reduces token consumption and hallucination risk by separating machine-critical facts from human context.",
  "skills": "./skills/",
  "author": {
    "name": "Niksa Barlovic",
    "email": "catcam@gmail.com"
  },
  "license": "MIT",
  "interface": {
    "displayName": "Documentation Standards",
    "shortDescription": "HADS (Human-AI Document Standard) — semantic tagging convention for writing documentation that works efficiently for…",
    "category": "Coding"
  }
}

plugins/documentation-standards/.claude-plugin/plugin.json

{
  "name": "documentation-standards",
  "version": "1.0.1",
  "description": "HADS (Human-AI Document Standard) — semantic tagging convention for writing documentation that works efficiently for both human readers and AI models. Reduces token consumption and hallucination risk by separating machine-critical facts from human context.",
  "author": {
    "name": "Niksa Barlovic",
    "email": "catcam@gmail.com"
  },
  "license": "MIT"
}