adv-instructions-audit

Audit documentation claims against executable test anchors for system fidelity.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Sharper-Flow/Advance --skill adv-instructions-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adv-instructions-audit
Source: https://github.com/Sharper-Flow/Advance/tree/main/skills/adv-instructions-audit
Command: npx skills add https://github.com/Sharper-Flow/Advance --skill adv-instructions-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of documentation drift, where instruction prose (like AGENTS.md or project.md) becomes disconnected from the actual executable behavior of the system.

Core Features & Use Cases

  • Fidelity Auditing: Verifies that every load-bearing claim in your documentation has a corresponding executable test anchor.
  • Drift Detection: Identifies contradictions between prose claims and the underlying system invariants.
  • Use Case: After a major refactor of your agent instructions, run this audit to ensure that all protocol rules still have valid, passing tests backing them up, preventing silent failures in your engineering contract.

Quick Start

Run the adv-instructions-audit skill to verify that all current project documentation claims are correctly anchored to the existing test suite.

Frequently Asked Questions about adv-instructions-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit technical documentation for drift against executable tests?

To audit technical documentation for drift, systematically map load-bearing claims in instruction prose to executable test anchors. This verifies that documentation remains synchronized with code-level invariants and protocol rules.

What is documentation drift in engineering workflows?

Documentation drift occurs when instruction prose like AGENTS.md becomes disconnected from actual executable system behavior. Auditing prose against executable anchors detects contradictions between claims and underlying invariants.

How do I verify instruction prose has valid test coverage after a refactor?

Verify instruction prose coverage after a refactor by running a fidelity audit to ensure every protocol rule has a corresponding passing test anchor. This prevents silent failures in your engineering contract.

Can I use docs-as-code auditing for AGENTS.md and project.md files?

Yes, docs-as-code auditing applies to files like AGENTS.md and project.md by systematically mapping load-bearing claims to drift-guard tests. This maintains an accurate engineering contract between prose and system invariants.

What is the best way to maintain engineering contracts between prose and code invariants?

The best way to maintain engineering contracts is systematic fidelity auditing, which maps instruction prose claims to executable test anchors to detect drift and ensure documentation matches protocol rules.