OpenSkillIndex← back to search
claude-code

Prism prism-advise

Get CLAUDE.md recommendations from PRISM. Use when asked to audit, fix, improve, or check what is wrong with a CLAUDE.md file.

install
source · Clone the upstream repo
git clone https://github.com/jakeefr/prism
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jakeefr/prism "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/prism-advise" ~/.claude/skills/jakeefr-prism-prism-advise && rm -rf "$T"
manifest: skills/prism-advise/SKILL.md
source content

prism-advise

Get concrete CLAUDE.md recommendations based on real session data.

When to use

When the user asks to audit their CLAUDE.md, fix their CLAUDE.md, improve their CLAUDE.md, or understand what is wrong with it.

Before running

First check if PRISM is installed:

prism --version

If the command is not found, install it first:

pip install prism-cc

Then verify it installed correctly:

prism --version

Once confirmed installed, proceed with the advise command.

Usage

Run the advisor for the current project:

prism advise --project .

For a different project:

prism advise --project <path>

Interpreting the output

PRISM prints recommendations with four action types:

  • ADD means a new rule should be added to CLAUDE.md. Session data shows a problem that no existing rule addresses. Example: retry loops caused by missing non-interactive flags.
  • TRIM means lines should be removed from CLAUDE.md. Usually personality or tone instructions past line 80 that waste tokens on every tool call.
  • WARN means an existing rule is being violated in sessions. The rule exists but Claude is not following it. May need stronger phrasing or better placement.
  • RESTRUCTURE means rules should be moved. Either to subdirectory CLAUDE.md files (if they only apply to one part of the codebase) or to the top/bottom of the file (if critical rules are buried in the attention dead zone).

Each recommendation includes an impact level (High, Medium, Low) and evidence from actual session data.

Applying recommendations

If the user wants to apply the ADD recommendations automatically:

prism advise --project . --apply

This adds new rules to the CLAUDE.md file. It will show a preview and ask for confirmation before writing anything. Only ADD recommendations are applied automatically. TRIM and RESTRUCTURE changes must be done by hand.

What PRISM checks

  • Whether CLAUDE.md is too long (adherence drops past 80 lines)
  • Whether critical rules are buried in the attention dead zone
  • Whether rules are being violated in actual sessions
  • Whether subdirectory-specific rules belong in subdirectory CLAUDE.md files
  • Whether interactive commands or retry loops need new rules
  • Whether migration file protections are missing