Where are the audit results stored?

All results are persisted as detailed Markdown reports in the $ACA_DATA/projects/aops/audit/ directory, categorized by date and time.

What does the Audit skill do in Claude Code?

The Audit skill synchronizes your project's filesystem with its documentation, curates index files for instructions like axioms and heuristics, and runs automated end-to-end acceptance tests.

Can this skill perform qualitative analysis?

Yes, it includes a specialized 'session-effectiveness' workflow that analyzes session transcripts to evaluate how well your framework is performing in practice.

Does it support broken link checking?

Yes, during the structural audit phase, it identifies and reports broken wikilinks to ensure documentation integrity.

How does it handle documentation accuracy?

It scans your source files and updates root-level indices, generates flowcharts for your project's logic, and ensures command tables in your README match the current codebase.

Framework Audit & Sync

Name: Framework Audit & Sync
Author: nicsuzor

bynicsuzor

0•

Security & Testing

Automates framework index curation, documentation synchronization, and agent-driven acceptance testing.

The Audit skill is a comprehensive utility designed for maintaining large-scale AI instruction frameworks and documentation-heavy repositories. It ensures the codebase remains consistent by synchronizing the filesystem with index maps, curating core instruction files like axioms and heuristics, and verifying documentation accuracy through automated flowchart regeneration. Beyond static analysis, it executes agent-driven end-to-end acceptance tests and generates detailed compliance reports, making it essential for developers who need to ensure their AI-driven workflows and system instructions stay perfectly aligned with their actual implementation.

Key Features

01Documentation Validation: Automatically regenerates README flowcharts and command tables to reflect current logic and hooks.

02Dynamic Index Curation: Updates core framework indices including axioms, heuristics, and skill lists using LLM judgment.

03Comprehensive Audit Reporting: Persists timestamped reports covering structural integrity, broken links, and test results.

04Agent-Driven Acceptance Testing: Executes end-to-end test cases to verify framework behavior and functional requirements.

050 GitHub stars

06Automated Filesystem Synchronization: Syncs physical file structures with central INDEX.md maps to eliminate documentation drift.

Use Cases

01Maintaining large AI instruction sets where indices frequently drift from the physical codebase.

02Performing qualitative assessments of session transcripts to evaluate AI framework effectiveness.

03Running automated regression tests to verify framework behavior after updates to core logic.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nicsuzor/aops-dist audit

For use in Claude.ai and ChatGPT

Download Skill