policy-audit

Audit repository policies and generate a Markdown report with file citations.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/alexgorbatchev/ai-registry --skill policy-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: policy-audit
Source: https://github.com/alexgorbatchev/ai-registry/tree/main/skills/policy-audit
Command: npx skills add https://github.com/alexgorbatchev/ai-registry --skill policy-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill performs rigorous checks to verify that repository policies for tests, CI, pre-commit hooks, AGENTS guidance, and deployment are defined, exercised, and enforced in checked-in code and docs.

Core Features & Use Cases

  • Conducts fixed-rubric policy audits against repo structure and docs.
  • Produces a formal Markdown report at docs/internal/audit/policy.md with traceable evidence.
  • Useful for compliance reviews, external audits, and internal policy enforcement.

Quick Start

Run a full policy audit against the repository and generate a concise Markdown audit report.

Frequently Asked Questions about policy-audit

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

FAQPage Schema
How do I audit repository policies for CI, tests, and deployment rules?

To audit repository policies, you run a fixed-rubric check against your repo structure and docs to verify tests, CI configurations, pre-commit hooks, and deployment rules are defined and enforced in checked-in code.

What is a repository policy audit and what evidence does it generate?

A repository policy audit verifies that AGENTS guidance, workflows, and release procedures are exercised in checked-in code, generating a formal Markdown report with citeable file paths and command outputs as evidence.

How do I generate a compliance report with file path citations for my repository?

You generate a compliance report by running an audit that produces a formal Markdown file at docs/internal/audit/policy.md, containing traceable evidence with direct citations to file paths and command outputs.

Does the policy audit check nested AGENTS docs and root level configurations?

Yes, the policy audit spans both root and nested AGENTS docs, checking workflows, release procedures, and deployment rules to ensure comprehensive policy enforcement across the entire repository structure.

Can I use this audit for external compliance reviews and internal policy enforcement?

Yes, you can use the generated formal Markdown audit report with its traceable file evidence for external compliance reviews, internal policy enforcement, and verifying pre-commit hooks are properly exercised.