skills.rest
nickgogan
nickgoganCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

system-audit

Audits agent definitions, skill contracts, governance compliance, and cross-references into a structured report.

Updated Apr 19, 2026
Search Tags:#consistency check#documentation drift#audit report#system audit#agent verification#cross-reference integrity#governance compliance
One-click install
npx skills add https://github.com/nickgogan/improvement-loop --skill system-audit-nickgogan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-audit
Source: https://github.com/nickgogan/improvement-loop/tree/main/.claude/skills/system-audit
Command: npx skills add https://github.com/nickgogan/improvement-loop --skill system-audit-nickgogan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large agent-driven systems drift over time: agent definitions fall out of sync with actual skills, governance rules go unenforced, and cross-references break silently. This Skill performs a full consistency audit of the Improvement Loop system and produces a persistent, severity-classified report. ## Core Features & Use Cases - Agent & Skill Verification: Checks every agent definition for completeness, validates skill frontmatter, and confirms skill inventories match actual SKILL.md files. - Governance & Structure Compliance: Verifies governance documentation, fractal directory pattern completeness, and CLAUDE.md factual accuracy. - Cross-Reference Integrity: Greps for DD/IB references, markdown links, and handoff protocol paths to detect broken links. - Use Case: Before archiving a milestone, run a full audit to confirm the system is clean, then review the prioritized remediation table to schedule fixes. ## Quick Start Run a full system audit of the Improvement Loop and write the findings report to operations/system-audits.

Frequently Asked Questions about system-audit

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

FAQPage Schema
How do I audit an agent-based system for consistency?▼

Run the system-audit skill, which checks agent definitions, skill contracts, governance docs, directory structure, and cross-references in sequence. It writes a severity-classified report to operations/system-audits with a prioritized remediation table.

What does the system audit check in skill contracts?▼

It validates that each SKILL.md has required frontmatter fields, is mapped to an agent's skill inventory, references only existing file paths, uses tools within its allowed-tools list, and complies with its stated autonomy tier.

When should I use system-audit instead of system-health?▼

Use system-audit for periodic deep reviews, before milestone completions, or when systemic issues are suspected. Use system-health for quick lightweight checks, since the audit is the comprehensive version that writes a persistent report.

Does the system audit fix the problems it finds?▼

No, the audit is strictly read-only analysis plus a written report. Fixes are deliberately separated into other skills or manual action, because mixing audit and repair compromises audit completeness.

How are audit findings classified and reported?▼

Every finding receives a severity of Critical, Warning, or Info, with evidence showing what was expected versus observed. The report includes category tables, a prioritized remediation table, and comparison with any previous audit.

Related Skills

Explore More Software Engineering Skills→
vibbsvibbs
6

system-maintenance

Audit and synchronize Company OS documentation after structural changes.

Community
Intermediate
poisontr33spoisontr33s

conceptualize

Audit governance and quality-control targets with findings-first remediation paths.

Community
Advanced
neuron-oneneuron-one
25

monitoring

Automate application and server monitoring with error tracking, metrics, and alerting.

Community
Intermediate
dotnetdotnet
209

reskill

Audit agent charters and histories to extract repeated patterns into shared skills.

Official
Intermediate