# Docs Check Compliance

> >

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

## Install

```sh
agentstack add skill-zio-zio-skills-docs-check-compliance
```

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

## About

# Check Documentation Compliance

## Arguments

1. **docs-file** — Path to documentation file (e.g., `docs/reference/xml.md`)
2. **rule-skill** — Rule skill name (e.g., `docs-writing-style`, `docs-mdoc-conventions`)

## CRITICAL REQUIREMENT

**YOU MUST create a comprehensive checklist of all rules from the rule skill and systematically verify each rule step by step until ensuring complete compliance with zero violations.** Do not skip rules, do not assume compliance without verification, and do not move forward until each rule is fully checked and any violations are fixed.

## Workflow

### Step 1: Load Rule Skill

**You MUST use the `Skill` tool to invoke the rule skill.** Do not substitute a different skill. Load it now:

Use the Skill tool with the rule-skill name. For example, if the rule-skill argument is `docs-writing-style`, invoke:

```
Skill: docs-writing-style
```

Read all rules it defines. For enumerated rule skills, note the rule numbers and create a checklist. These are the only rules you will enforce.

### Step 2: Read Doc File

Read the full documentation file to understand its current state.

Use the Read tool with the docs-file path. For example, if the docs-file argument is `docs/reference/chunk.md`, invoke:

```
Read: /docs/reference/chunk.md
```

Note: Always use absolute paths (starting from `/`)

### Step 3: Check and Fix Each Rule

**MUST: Create a comprehensive checklist of ALL rules defined by the rule skill.** Number each rule and list it with its full name and description. Display this checklist to the user so they see exactly what will be checked.

**Then, process each rule from the checklist sequentially, ensuring zero violations before moving to the next rule.** Do not skip any rule. Do not assume compliance without verification.

For each rule in your checklist:

1. **Identify violations** — Use adversarial verification: assume the document fully complies with THIS RULE, then prove yourself wrong by finding evidence of violations. Cite exact line numbers, quote problematic text, and explain why it violates THIS RULE. If you cannot find evidence, this rule has zero violations.

2. **Fix violations** — Apply minimal edits (add, remove, edit, or restructure as needed). Preserve the intent of the document.

3. **Commit immediately** — Run:
   ```bash
   git add 
   git commit -m "docs(): fix "
   ```
   Example: `git commit -m "docs(chunk): fix rule-2-sentence-clarity"`

**Repeat steps 1–3 for each rule until zero violations remain, then proceed to the next rule.**

### Step 4: Compile

Run mdoc to verify the doc compiles without errors:

```bash
sbt "docs/mdoc --in docs/reference/chunk.md"
```

(Substitute the actual docs-file path.)

If mdoc fails, identify the error, fix it, and commit:
```bash
git add 
git commit -m "docs(): fix mdoc error"
```

### Step 5: Report

Output a summary including:
- Total violations found and fixed per rule
- Which rules had zero violations (no changes needed)
- Final mdoc status (pass/fail)

---

## Key Principles

- **One commit per rule violation** — not one big commit
- **Commit immediately after each fix** — don't batch
- **Verify mdoc passes at the end** — this is the final proof of correctness
- **Be concise** — minimal changes, preserve intent

---

## Example Invocation

To check `docs/reference/chunk.md` against the `docs-writing-style` rule skill:

1. Load the rule skill: `Skill: docs-writing-style`
2. Read the doc file: `Read: /docs/reference/chunk.md`
3. For each rule, find violations, fix, and commit
4. Run: `sbt "docs/mdoc --in docs/reference/chunk.md"`
5. Report results

Example commit message:
```
docs(chunk): fix rule-3-active-voice
```

## Source & license

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

- **Author:** [zio](https://github.com/zio)
- **Source:** [zio/zio-skills](https://github.com/zio/zio-skills)
- **License:** Apache-2.0

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-zio-zio-skills-docs-check-compliance
- Seller: https://agentstack.voostack.com/s/zio
- 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%.