# Documentation Standards

> Two documentation skills: HADS, a tagging convention people and AI both read well, and grounded vaults that trace every claim to its source.

Documentation Standards is a pair of agent skills from Seth Hobson's agents collection (wshobson/agents), a community project. They teach your agent two conventions for documents that agents and people both rely on.

What its skills teach
- hads: the Human-AI Document Standard, created by Nikša Barlović. It's plain Markdown where each block is tagged [SPEC] (terse facts), [NOTE] (human context), [BUG] (a verified failure with its symptom, cause and fix) or [?] (unverified), with a short reading instruction at the top that tells a model what to read and what to skip. Your agent can write new docs in HADS, convert an existing README, check that a document follows the rules, and answer from a HADS doc by reading its [SPEC] and [BUG] blocks first.
- grounded-vault: a three-layer Markdown knowledge store: raw/ sources that are never edited, compiled wiki/ pages, and an archive/ for pages that drifted or were replaced. Every number, date or quote on a wiki page links to its source, each page records the git commit it was compiled against and the code paths it describes, and one git diff shows when a page has gone stale, without spending model tokens.

How to install it
In Claude Code, run /plugin marketplace add wshobson/agents, then /plugin install documentation-standards@claude-code-workflows. Codex CLI uses codex plugin marketplace add wshobson/agents, the repository has routes for Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, and npx skills add wshobson/agents installs single skills.

Good to know
- HADS needs no tooling: it's standard Markdown that any editor renders. The skill notes that a validator is planned but not included yet.
- grounded-vault needs only a git repository. Its reference file covers a check script you can run from a pre-commit hook or CI, so a page can't land with an unsourced number or a stale fingerprint.
- HADS is Nikša Barlović's open standard (MIT). The grounded-vault layout comes from the llm-wiki-loop project, which the skill treats as a reference rather than a dependency.

- Type: Skill
- Made by: wshobson
- Category: Writing
- Formats: Skills, Claude plugins
- Version: latest
- Website: https://github.com/wshobson/agents
- Source: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards
- Page: https://pluginboard.ai/skills/documentation-standards

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the documentation-standards folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Gemini

In Gemini: Download the documentation-standards folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### GitHub Copilot

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.copilot/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.copilot/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Cursor

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.cursor/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.cursor/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Claude Code

In Claude Code, as a plugin:

```text
/plugin marketplace add wshobson/agents
/plugin install documentation-standards@claude-code-workflows
```

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.claude/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.claude/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Codex

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.agents/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.agents/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Antigravity

In Antigravity: Copy the documentation-standards folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Gemini CLI

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.gemini/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.gemini/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Replit

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault .agents/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads .agents/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### OpenClaw

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.openclaw/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.openclaw/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### OpenCode

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.config/opencode/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.config/opencode/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

### Hermes Agent

Copy all 2 skills, in your terminal:

```shell
npx -y degit wshobson/agents/plugins/documentation-standards/skills/grounded-vault ~/.hermes/skills/grounded-vault
npx -y degit wshobson/agents/plugins/documentation-standards/skills/hads ~/.hermes/skills/hads
```

View the skills on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/documentation-standards

---
From Pluginboard (https://pluginboard.ai).
