docguard: Skill for Claude Code

.agent/skills/docguard-fix/SKILL.md

docguard-fix is a skill for Claude Code from raccioly/docguard. It costs 45 tokens per session (2,776 once invoked), scanned A, original, MIT.

A tool for repairing project documentation by researching the actual codebase and checking the result against documentation rules. It focuses on canonical documents, meaning the official versions a project relies on.

In plain words
What is it for?
Use it to fix one named document or all issues found by docguard diagnose. It can remove API entries that no longer match the project’s OpenAPI specification and repeat checks until the documentation passes.
Why use it?
It removes outdated, generic, or placeholder documentation and catches problems through repeated validation. It also creates a backup before overwriting a document.

Skill for Claude Code

Written for Claude Code: $ARGUMENTS substitution.

This is raccioly/docguard's own configuration. It tells Claude Code how to work on docguard itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything docguard configures →

Reuse

Borrowing it

Nothing to install: this file belongs to raccioly/docguard. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/raccioly/docguard/main/.agent/skills/docguard-fix/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/raccioly/docguard

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for docguard-fix

README.md
[![agentmods](https://agentmods.dev/badge/skills/raccioly/docguard/docguard-fix/github.svg)](https://agentmods.dev/skills/raccioly/docguard/docguard-fix)
Your own site
<a href="https://agentmods.dev/skills/raccioly/docguard/docguard-fix"><img src="https://agentmods.dev/badge/skills/raccioly/docguard/docguard-fix/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for docguard-fix

Your own site · 80×15
<a href="https://agentmods.dev/skills/raccioly/docguard/docguard-fix"><img src="https://agentmods.dev/badge/skills/raccioly/docguard/docguard-fix.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,776 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 5 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Prompt Injection · line 12
    Hidden instructions were detected in comments or invisible text. These could contain malicious directives. Manual review is recommended.
    Fix: Audit all comments and invisible characters. Remove any instructions that direct the agent to perform unauthorized actions. Use plain, reviewable content.
  • medium MCP Rug Pull · line 6
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 42
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 54
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 173
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.02776
Opus 5.5 $0.00018 $0.01110
Sonnet 5.5 $0.00009 $0.00555
Haiku 4.5 $0.00005 $0.00278

Measured 6d ago against content hash 650a5d7e53ff, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

docguard-fix scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agent/skills/docguard-fix/SKILL.md · 264 lines

How it starts

The opening of the file, as written. The whole thing — 264 lines — stays where its author put it; the contents beside it link to each section on GitHub.

DocGuard Fix Skill

Running DocGuard

Run docguard from PATH when it is installed. Otherwise run npx --yes [email protected], the release these instructions ship with, in its place. Every docguard … command below means one of the two.

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty). If user specifies --doc <name>, focus on that single document. If no arguments, fix ALL issues found by docguard diagnose.

Goal

Research the actual codebase to generate or repair canonical documentation that passes DocGuard's configurable guard suite. This skill replaces generic templates with real, project-specific content and iterates until quality checks pass.

Operating Constraints

  • NEVER use placeholder content — every section must reference real files, real modules, real dependencies
  • ALWAYS back up before overwriting — use safeWrite() pattern or create .bak files
  • Maximum 3 validation iterations — if still failing after 3 rounds, report remaining issues and stop
  • Research before writing — understand the codebase first, then generate documentation

Scope: act findings only

Read disposition from docguard guard --format json before repairing anything.

  • act — DocGuard asserts a defect and names the correction. In scope.
  • escalate — DocGuard observed a signal and the judgement belongs to a human (freshness history, diff-overlap suspicion, documented-endpoint absence). Out of scope for this skill. Report them for review; never edit a document to silence one. A history heuristic saying a review is DUE is not evidence that the document is wrong, and stamping a new review date to clear it destroys the signal without doing the review.

Also read parserTier: a finding produced by regex-fallback or fallback-language came from a pattern match rather than a syntax tree, so verify the underlying source before rewriting a document around it.

Read the full file on GitHub · 264 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago Changed 650a5d7e53ff
  2. 9d ago Changed f501256b4136
  3. 11d ago Changed d8b4431d5ea2
  4. 12d ago Changed 4775c76abf3d
  5. 21d ago Changed · +6 lines 5a0f0d0bb90d
  6. 22d ago Changed · +8 lines b86b614b640f
  7. 1mo ago Changed · +9 lines ddfbcf8a6b75
  8. 1mo ago Changed c9fe6d3bde27
  9. 1mo ago Changed 3ff97cf8a9e6
  10. 1mo ago First seen · 241 lines · 45 tokens per session scan A d637a785a526

Subscribe to this mod's changes

docguard-fix is a skill published in the GitHub repository raccioly/docguard (32 stars, last pushed 3d ago), licensed MIT. It adds 45 tokens to every session and 2,776 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.