# Documentation

> Canonical documentation capability for audit, drift, validate, and author modes in hve-core.

- **Type:** Skill
- **Install:** `agentstack add skill-microsoft-hve-core-documentation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [microsoft](https://agentstack.voostack.com/s/microsoft)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [microsoft](https://github.com/microsoft)
- **Source:** https://github.com/microsoft/hve-core/tree/main/.github/skills/hve-core/documentation

## Install

```sh
agentstack add skill-microsoft-hve-core-documentation
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# documentation

## Overview

This skill provides the shared documentation capability used by the Documentation agent.
It centralizes the durable knowledge for audit, drift, validate, and author flows in a
single package so thin wrappers can load mode-specific guidance instead of embedding
capability prose inline.

## Mode map

The Documentation agent should load the relevant skill sections by mode:

| Mode       | Primary load targets                                                                                                                                                                   | Notes                                                                              |
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|
| `audit`    | `references/conventions.md`, `references/coverage-method.md`, `references/validation-toolchain.md`, `references/content-sensitivity.md`                                                | Replaces the former Doc Ops workflow with a skill-driven audit loop.               |
| `drift`    | `references/conventions.md`, `references/code-doc-mapping.md`, `references/content-sensitivity.md`                                                                                     | Uses the repo-local mapping table and drift heuristics.                            |
| `validate` | `references/validation-toolchain.md`, `references/accessibility-checks.md`, `references/content-sensitivity.md`, `references/rai-guardrails.md`                                        | Runs docs validation and escalates formal review when needed.                      |
| `author`   | `templates/guide.md`, `templates/reference.md`, `references/conventions.md`, `references/accessibility-checks.md`, `references/content-sensitivity.md`, `references/rai-guardrails.md` | Produces narrative or reference docs with the repository's documented conventions. |

## Non-goals

This skill does not author ADRs, BRDs, PRDs, or other planning artifacts.
It also does not embed accessibility, RAI, or security standards logic inline;
it points to the dedicated reference files and routes formal assessment to the
appropriate planner when the scenario requires it.

## Working conventions

- Prefer existing repository instructions and scripts over duplicated prose.
- Keep documentation changes factual and scoped to the current task.
- Use the reference files below for mode-specific methods, heuristics, and checklists.
- Escalate to planners for formal accessibility, RAI, or security review if the work
  requires a specialist assessment.

## Session tracking

Write session state to `.copilot-tracking/documentation/` using a
`{{YYYY-MM-DD}}-session.md` file for the run, following the standard session file conventions.

## Reference files

- `references/conventions.md` — Synthesis of the repository's markdown, writing-style,
  and Docusaurus conventions.
- `references/code-doc-mapping.md` — Code-to-documentation mapping table and drift heuristics.
- `references/coverage-method.md` — Gap and coverage analysis method for audit mode.
- `references/validation-toolchain.md` — Validation command catalog and result interpretation.
- `references/accessibility-checks.md` — Inline documentation checks and handoff triggers.
- `references/content-sensitivity.md` — Pre-publish PII, secrets, confidentiality, and
  AI-disclosure checks.
- `references/rai-guardrails.md` — Injection-boundary, attribution, human-review, and
  disclaimer guidance.

## Templates

- `templates/guide.md` — Structure template for narrative guides and how-to pages.
- `templates/reference.md` — Structure template for reference and API-style documentation.

---

> Brought to you by microsoft/hve-core

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [microsoft](https://github.com/microsoft)
- **Source:** [microsoft/hve-core](https://github.com/microsoft/hve-core)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-microsoft-hve-core-documentation
- Seller: https://agentstack.voostack.com/s/microsoft
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.