Module audit
Skill wednesday-solutions/ai-agent-skills/skills/agents/module-audit
Use when asked to audit a module, check its health, or assess whether it should be refactored. Runs structural query, risk check, and test generation automatically.From its SKILL.md
npx -y skills add wednesday-solutions/ai-agent-skills --skill module-auditAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- runs commandsInstructs the agent to run 3 commands, including `wednesday-skills score <module>` and 2 more.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
1.7 KB, 321 tokens by cl100k_base, as published. Nobody here has run it
Module Audit Agent
When to use
- "Audit this module"
- "Is it safe to refactor X?"
- "What is the health of this service?"
- "Should we rewrite X?"
What to do
-
In parallel:
- brownfield-chat — Read
dep-graph.jsonandsummaries.jsonfor the target module. Report: what it does, its imports, what imports it, and any known conflicts. - brownfield-fix — Run
wednesday-skills score <module>andwednesday-skills blast <module>. Report risk band and total dependent count.
- brownfield-chat — Read
-
Present the combined audit report:
- Purpose summary (from summaries.json)
- Risk score + band (0–30 low / 31–60 medium / 61–80 high / 81–100 critical)
- Blast radius (dependent count, cross-language flagged separately)
- Architecture violations or danger zone warnings (from MASTER.md)
- Recommendation: proceed / review / senior sign-off / do not touch
-
brownfield-tests — Only run if coverage < 30% AND risk > 50:
- Run
wednesday-skills gen-tests --file <module> - Show generated test file to dev for review before writing
- Run
Never
- Recommend refactoring a critical file (risk > 80) without flagging the blast radius
- Read raw source to answer structural questions — use graph only
- Auto-write test files without showing the dev first
What ships with it: 1 file
253 B alongside SKILL.md
- agent.yml253 B