audit-code

When to use this skill

Use when the user wants to improve their codebase architecture by checking it against skills present in the registry. Invoked as /audit-code (Claude Code) or @audit-code (Cursor).

Configuration

• Primary source: All configured registries in ~/.prism/registries.json (with per-registry caching and source tagging)
• Fallback 1: Local skill-registry.json in the current project directory
• Fallback 2: Local _analysis/extracted_skills_codebase/ skill directories
• Authentication: REGISTRY_TOKEN environment variable (global override) or per-registry token from registries.json

Skills from multiple registries are merged and each result is tagged with [registry-name] (e.g., [team], [community]) to identify the source.

Instructions

Step 1 -- Resolve skill registry source

Read ~/.prism/skills/_shared/registry-fetch.md and follow its instructions. It resolves all configured registries with ETag caching and local fallbacks, returning a skills array where each entry is tagged with _registry.

Outcomes:

• Valid JSON array → use as the skills list, proceed to Step 2
• REGISTRY_EMPTY → registry reached but empty, proceed to Step 2
• NO_REGISTRIES → no registry reachable, stop (the shared file handles the user message)

Step 2 -- Check for empty registry

If the skills array from the resolved source is empty, respond with: "No skills have been published to the registry yet." and stop.

Step 2.5 -- Check for existing analysis files

Check which analysis files exist:

for f in _analysis/full_report.md _analysis/design.md _analysis/directives.md _analysis/incidents.md; do
  test -f "$f" && echo "FOUND: $f" || echo "MISSING: $f"
done

If at least one file is found, list them and ask the user:

"Found existing analysis files in _analysis/: {list found files}

Use these for matching, or run a fresh codebase scan?"

• Fresh scan chosen → skip to Step 3, Path B.
• Use existing files chosen → read all found files now (see table below), then continue to Step 3, Path A.
• No files found → skip to Step 3, Path B.