directives-audit

Audit agent directive files for authority, scope, safety, routing, and drift.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill directives-audit-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: directives-audit
Source: https://github.com/allemaar/open-skills/tree/main/skills/directives-audit
Command: npx skills add https://github.com/allemaar/open-skills --skill directives-audit-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Agent directive files accumulate contradictions, stale rules, redundant guidance, and broken routing over time, silently degrading how AI agents behave. This Skill audits directive systems against explicit dimensions so you can find and fix authority conflicts, unsafe gaps, and drift before they cause failures. ## Core Features & Use Cases - Read-only audit mode: Traverses every in-scope directive file, router, projection, and consumed entrypoint, classifying each material rule as KEEP, CUT, REWRITE, MOVE, SPLIT, or ENFORCE with severity and conflict fields. - Gated housekeeping mode: Applies selected findings only after explicit approval, with canonical-source resolution, symlink rejection, atomic writes, recoverable preimages, and partial-failure rollback rules. - Parity and behavior verification: Claims source-to-consumed parity only from target-exclusive comparison and consumed behavior only from discriminating controls, avoiding unsupported claims. - Use Case: Your CLAUDE.md and routed conditional rule files have grown for a year. Run the audit to surface contradictions, stale project-specific rules, and missing fallback behavior, then selectively housekeep the findings. ## Quick Start Ask the agent to audit my directive files for authority conflicts, stale rules, and routing gaps using /directives-audit.

Frequently Asked Questions about directives-audit

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

FAQPage Schema
How do I audit AI agent instruction files for contradictions?

Run a directives audit that reads every in-scope directive file, router, and projection, then classifies each material rule with a disposition, conflict, and severity field. Contradictions are reported as exact competing clauses with file and location citations.

What is the difference between auditing directives and auditing skills?

Directive audits cover standing authority, cross-task scope, safety gates, load order, and conditional routing. Skill audits cover invocation, workflow, frontmatter, references, and dependencies. Mixed artifacts should have each dimension routed to its owning audit.

Can the audit edit my directive files automatically?

No. The default mode is strictly read-only. Housekeeping runs only after an explicit edit or apply-selected-findings request, requires approval of exact targets, and uses atomic writes with recoverable preimages and partial-failure rollback rules.

How is source-to-consumed parity verified in a directive system?

Parity is claimed only from a target-exclusive comparison covering every declared surface, and consumed behavior only from the consumed entrypoint with a discriminating control. If that evidence is unavailable, the claim is marked unknown rather than assumed.

When should I not use a directives audit?

Do not use it for reader-facing prose wording, which belongs to a prose audit, or for skill invocation and workflow issues, which belong to a skills audit. It also does not replace maintenance adapters, projectors, installers, or managed-file owners.