Audit context
Evaluates ambient context artifacts (CLAUDE.md, memory, local skills, settings hooks) for compatibility with swarm governance. Returns a classified report so users can address interference before launching a team.From its SKILL.md
npx -y skills add DheerG/swarms --skill audit-contextAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
5.5 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it
Audit Context
Evaluate the user's ambient context artifacts for compatibility with swarm's governance rules. You are a read-only diagnostic — never modify any files.
What to scan
- CLAUDE.md files. Read the project's
CLAUDE.md(working directory root). If.claude/CLAUDE.mdexists, read that too. Also check~/.claude/CLAUDE.md(global config) — it loads into every session. - Memory files. Find the project memory path by checking
~/.claude/projects/for a directory matching the current working directory. Claude Code dash-encodes the project path (e.g.,/Users/foo/my-projectbecomes-Users-foo-my-project). If amemory/MEMORY.mdindex exists, read it and follow links to individual memory files. - Local skills and commands. List
.claude/skills/and.claude/commands/in the project directory. Flag any skill whose name matches a swarm built-in:suggest-members,define-rubric,resolve-dispute,writing-style,reflect-outcome,independent-review-loop,code-mode,triage-mode,writing-mode,general-mode,workflow-rules,audit-context. - Settings hooks. Check both
.claude/settings.json(project) and~/.claude/settings.json(global) for ahookssection. Flag any hook that intercepts tools used by swarm (the Agent tool, SendMessage, or CronCreate).
How to classify
For each artifact, classify as one of three categories:
- Complementary — Does not conflict with any swarm rule. Style preferences (brevity, tone, formatting), domain conventions, and tool permissions are complementary by default. No action needed.
- Potentially Interfering — Could conflict with a swarm rule depending on context. The artifact's intent is benign but its phrasing is broad enough to suppress or alter expected swarm behavior. Worth reviewing.
- Conflicting — Directly contradicts a named swarm governance rule. Will likely cause unexpected behavior during a team run. Should be addressed before launching.
Swarm governance rules to evaluate against
These are the rules that matter for interference detection:
Workflow control
- After greenlight, execution is autonomous — no mid-phase confirmations unless escalating per hard rules.
- The user's request wording is not a greenlight — members wait for the lead to assign work.
- Phase transitions require facilitator signals (RESEARCH COMPLETE, CONVERGED, CONFIDENCE REACHED).
- Final delivery requires explicit user sign-off.
Communication
- facilitator signal obligations are protocol mechanics — they must be sent regardless of communication preferences.
- Favor brevity during roundtables. No idle chatter.
- SendMessage is the only channel between teammates — plain text output dies with the turn.
Execution
- All members except the lead are read-only.
- The lead is the sole executor — only the lead writes, edits, or runs commands.
- No code changes during review rounds.
- Wait for ALL reviews before making changes.
Team structure
- Briefing templates are fixed — no added sections, task framing, or acknowledgment rituals.
- Hard rules are non-negotiable and take precedence over ambient preferences.
Common interference patterns
Flag these specific patterns when you encounter them:
| Pattern | Example | Classification | Conflicting rule |
|---|---|---|---|
| Confirmation injection | "Always confirm before editing" | Conflicting | Autonomous post-greenlight execution |
| Auto-commit/push | "Commit after completing work" | Conflicting | Final delivery requires user approval |
| Silence preferences | "Don't repeat yourself", "Stay silent while waiting" | Potentially Interfering | facilitator signal obligations |
| Verbosity injection | "Explain your reasoning step by step" | Potentially Interfering | Favor brevity during roundtables |
| Methodology injection | "Always use TDD", "Write tests first" | Potentially Interfering | Phase arc is defined by mode skill |
| Tool restrictions | "Don't spawn agents", "Never spawn subagents" | Conflicting | Create the team per Step 8a |
| Briefing expansion | "Add detailed context to all briefs" | Conflicting | Briefing templates are fixed |
| Skill name collision | Local suggest-members skill | Conflicting | Shadows swarm built-in |
| Hook tool interception | Hook that blocks the Agent tool or SendMessage | Conflicting | Team creation and communication require these tools |
Output format
Present findings as a structured report grouped by source:
## Audit Results
### CLAUDE.md — [path]
- [excerpt] — **[Classification]** — conflicts with: [rule name]. [One-line recommendation.]
### Memory — [path]
- [excerpt] — **[Classification]** — conflicts with: [rule name]. [One-line recommendation.]
### Local Skills / Commands
- [name] — **[Classification]** — [reason]. [One-line recommendation.]
### Settings Hooks — .claude/settings.json
- [hook name / tool target] — **[Classification]** — [reason]. [One-line recommendation.]
### Summary
- Complementary: [count]
- Potentially Interfering: [count]
- Conflicting: [count]
If no artifacts are found, say so. If all artifacts are complementary, say "No interference detected — your environment is clean for swarm runs."
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most audit compliance skills give in ~1.2k tokens
Counted across 960 of the 1,589 authors here whose files we hold, read 2026-09-06
- Read product marketing context before asking questionsin 29 of 960, across 11 files
- Rank findings by severityin 29 of 960, across 22 files
- Generate audit reportin 22 of 960
- Run the audit scriptin 20 of 960, across 19 files
- Generate a prioritized action plan reportin 19 of 960, across 11 files
- Ensure one H1 per pagein 15 of 960, across 5 files
- Ensure sitemap exists and is accessiblein 14 of 960, across 4 files
- Verify alt text on all imagesin 12 of 960, across 3 files
- Determine the audit scope before startingin 12 of 960, across 4 files
- Verify important pages allowed in robots.txtin 11 of 960, across 2 files
- Detect business type from homepage signalsin 11 of 960, across 7 files
- Delegate specialized tasks to subagentsin 11 of 960, across 7 files
Said here and by no other author read
- Check global CLAUDE.md configuration
- Find the project memory path
- List local skills and commands
- Check settings hooks for interference
- Classify artifacts into three categories
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.