{
  "markdown": "# agentdocs — The Source-Complete Standard\n\nAn installable **Agent Skill** for authoring and validating **HTML-first, agent-readable\ndocumentation**: one static HTML file that serves AI agents first and humans second — no\nview-time JavaScript, no content duplication.\n\n- **The skill:** [`skills/agentdocs/`](skills/agentdocs/)\n- **The standard it teaches:** [`STANDARD.md`](skills/agentdocs/reference/STANDARD.md)\n- **A conforming exemplar:** [`standard.html`](skills/agentdocs/templates/standard.html)\n- **Status:** v0.1 draft (three open items tracked in `STANDARD.md §10`).\n\n## What it does\n\nTwo workflows: **Author** a conforming doc (architecture overview, subsystem contract, API\nreference, data model, UI/wireframe spec, runbook, or front-door index), and **Validate** an\nexisting doc against an 8-gate conformance checklist.\n\nThe five conformance rules in brief: (1) agents read the raw source; (2) source-complete, no\nview-time JS; (3) content inline, CSS free; (4) faceted multi-axis `data-*` tags; (5) one\n`data-source` + `data-verified` provenance primitive — plus *one shared toolkit + one construct\nper doc type*.\n\n---\n\n## Install\n\nPick the path that fits your tool. **The skill lives at `skills/agentdocs/`** — that's the only\nfolder you ever copy.\n\n### One command (any machine with bash + git)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/george4data/agentic_html_doc/main/install.sh | bash\n```\n\nPersonal install → `~/.claude/skills/agentdocs`. Add `--project` (when running a local clone's\n`./install.sh --project`) to install into the current repo's `./.claude/skills/` instead.\n\n### Claude Code — as a managed plugin (gets `/plugin` updates)\n\n```text\n/plugin marketplace add george4data/agentic_html_doc\n/plugin install agentdocs@agentic-html-doc\n```\n\n### Gemini CLI — as an extension\n\n```bash\ngemini extensions install https://github.com/george4data/agentic_html_doc\n```\n\nLoads [`GEMINI.md`](GEMINI.md), which routes the agent to the skill's operating manual.\n\n### Manual copy (no installer, no plugin system)\n\n```bash\ngit clone --depth 1 https://github.com/george4data/agentic_html_doc.git\ncp -R agentic_html_doc/skills/agentdocs ~/.claude/skills/agentdocs\n```\n\n### claude.ai / Gemini app (web)\n\nNo GitHub auto-install in the web apps:\n- **claude.ai:** upload the `skills/agentdocs/` folder in the Skills UI.\n- **Gemini app:** create a Gem, paste the body of `SKILL.md` as instructions, attach the\n  `reference/` and `templates/` files as knowledge.\n\n---\n\n## Asking an agent to install it\n\nIf you'd rather just tell Claude / Antigravity / another agent to do it, give it the exact path\nso it doesn't have to explore:\n\n> \"Install the skill at `https://github.com/george4data/agentic_html_doc` — clone it and copy\n> `skills/agentdocs/` into `~/.claude/skills/agentdocs/`. Or just run its `install.sh`.\"\n\n---\n\n## Verify the install\n\nAsk the agent:\n\n> \"Use **agentdocs** to validate `templates/standard.html` against the Source-Complete Standard.\"\n\nA correct install runs the validation workflow and returns an 8-gate table ending in\n**CONFORMS** — the bundled exemplar is conformant by construction.\n\n## How invocation works\n\n`agentdocs` is **model-invoked**, not a slash command. Describe your task in natural language\n(\"write agent-readable docs for the auth service\", \"validate these HTML docs\") and the agent\nloads the skill when it matches. To force it, name it: *\"use the agentdocs skill to…\"*.\n\n## Repository layout\n\n```\nagentic_html_doc/\n├── .claude-plugin/\n│   ├── marketplace.json     ← Claude Code marketplace index (plugin source: \".\")\n│   └── plugin.json          ← Claude Code plugin manifest\n├── gemini-extension.json    ← Gemini CLI extension manifest\n├── GEMINI.md                ← Gemini context file\n├── install.sh               ← one-command installer\n├── README.md\n├── LICENSE\n└── skills/\n    └── agentdocs/           ← the skill (this is the only folder you copy)\n        ├── SKILL.md         ← operating manual (author + validate)\n        ├── reference/       ← STANDARD.md, facet-ontology, constructs, checklist\n        └── templates/standard.html  ← conforming exemplar\n```\n\n## License\n\n[MIT](LICENSE) — free to use, modify, and redistribute.\n\n## Status\n\nDraft v0.1. The base facet vocabulary, a reference author-time (Pandoc) build, and a\ndocs-specific conformance benchmark are open items — see `STANDARD.md §10`.\n",
  "bytes": 4369,
  "sha": "ca3f66c050e7f7cdb1b6764c40c2e02944ca43cc4370f5a3f5f7f7452de5b318",
  "repo_slug": "george4data/agentic_html_doc",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_george4data_agentic_html_doc_c71948ae/readme"
}