TsukiNi22/ai-utils / skills/audit/audit-quality
audit-quality
VerifiedCleanliness / convention audit -> PDF report
<name> (a skill) = the folder of that skill: ~/.claude/skills/<name> (setup.sh) or ${CLAUDE_SKILL_DIR}/../../*/<name> (plugin of the marketplace).
Report only: never modify the project during the audit (fixes only if asked afterwards).
SKILL_DIR = directory of this file.
1. Ask (one AskUserQuestion call, French) - only what the request doesn't say
- Scope: whole project / a module / the changes since a ref.
- Compiler warnings pass (
--build, slower: separate build dir in /tmp). - Output: ask the output format of
report(Markdown + PDFrecommended, PDF only, Markdown only); locationaudit/at the root of the repository (or of the current folder outside a repository), neverdocs/unless asked (audit/<YYYY-MM-DD>-quality.{md,pdf}); language English unless asked. Never start subagents (forks) by yourself: propose them only for very big projects and wait for the user's yes.
2. Objective metrics
python3 SKILL_DIR/scripts/collect.py <root> --json /tmp/audit.json --md /tmp/audit-tables.md [--build]
Categories (every finding has file:line): headers (Xartania/Epitech header missing), guards (NAME_H not
matching the file), auto (outside iterators / structured bindings / lambdas), using-namespace, void-params
(function with a return type and ()), c-cast, null, tabs, trailing-spaces, todo, cmake (source not
listed, GLOB), gitignore (outputs not ignored), commits (not type(scope): message), ai-attribution,
untested (public names never referenced by the tests, via cpp-tests), docs (README/CHANGELOG/LICENSE missing,
CHANGELOG version != CMake version), warnings (with --build).
The script is heuristic: check a sample of each category before reporting it, drop the false positives.
When xstyle is installed (command -v xstyle, packages of TsukiNi22/xstyle), also run
xstyle --rtk -r <root> -S -o /tmp/xstyle.json (the JSON for the counters, xstyle --rtk -r <root> to read the issues): ~65 rules of cpp-style / cpp-comments / coding-style / libutils usage
with a severity (unforgivable / major / minor / negligible) and the counters by rule; use its counters in the report
(sample-check them as well) and point to xstyle --fix [CODES] for the fixable ones (the command given to the user, who reads the human
output; the assistant itself always runs xstyle with --rtk).
2b. Dependencies (licenses + vulnerabilities, transitive)
python3 <audit-deps>/scripts/deps.py <root> --transitive --json /tmp/deps.json --md /tmp/deps.md
python3 <audit-deps>/scripts/vulns.py <root> --json /tmp/vulns.json --md /tmp/vulns.md
Licenses to credit / restrictive / unknown (see audit-deps), known vulnerabilities and compromised versions
(OSV, dnf advisories, GitHub advisories), recent ones (< 90 days) first; for each one check whether the project
uses the vulnerable part. Dependencies of the dependencies are included.
3. Manual review (what a script can't see)
Load the convention skills and read a representative sample of each module (most recent files first):
cpp-style(naming, braces,this->, one-liners, const, alignment),cpp-comments/comments,cpp-class(reference/layout.md: sections, class blocks order, rule of five, include comments, namespaces),cmake-style(section order, banners, modes, packaging),git-conventions(history, tags, CHANGELOG),readme-style/html-doc(docs),cpp-tests(tests structure),license(scripts/license.py identify). Also: dead code, duplicated code, very long functions, magic numbers, inconsistent naming between modules, files in the wrong folder, leftovers at the root (tmp.cpp,a.out...).
4. Score and priorities
Per category: number of findings, severity (high: breaks the build/CI/conventions everywhere, medium:
recurrent deviation, low: cosmetic), a 0-10 score, the fix (and if it can be automated: sed, script,
clang-format...). Then a top 10 of the actions with the best gain / effort ratio.
5. Report (report skill)
Write the Markdown from report/templates/report.md, sections:
- Summary: table
| Category | Findings | Severity | Score /10 |+ global score + 3-line verdict. - Method: scope, commit (
git rev-parse --short HEAD), date, tools and skills used, limits (heuristics). - Findings by category: one
###per category, a short explanation of the rule (with the skill it comes from), a table| File:line | Finding | Fix |(max ~15 rows, the rest in the annex). - Dependencies: licenses (table + obligations) and vulnerabilities (table by severity, recent first, fixed version, action).
- Priorities: the top 10, numbered
1. **Action.** gain, effort, files. - Appendix: full lists per category (from the JSON), module sizes table.
- Sources: the skills / rules / tools used.
Then
python3 <report>/scripts/md2pdf.py <report.md> --footer "<Project> — quality audit" --format <answer>, check the rendering (pdftoppm on 2 pages) and give both paths + page count.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |