Skill

prism-advise

Audits CLAUDE.md files using PRISM CLI to recommend ADD, TRIM, WARN, and RESTRUCTURE changes based on session data. Use to fix rule violations, length issues, and placements.

Python

Bash

Markdown

developer-tools

code-quality

npx claudepluginhub jakeefr/prism --plugin prism

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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

SKILL.md

Similar Skills

claudit

Audits Claude Code configurations for best practices in skills, instructions, MCP servers, hooks, plugins, security, over-engineering, and context efficiency via file scans and focused checks. Invoke with /claudit [focus-area].

3 files8 tools

claudit

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars19

Forks1

Last CommitApr 27, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

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>

From an agentsview database (real API token counts, richer data):

prism advise --source agentsview
prism advise --source agentsview --agentsview-db /path/to/sessions.db

DB path resolution: AGENTSVIEW_DATA_DIR → AGENT_VIEWER_DATA_DIR → ~/.agentsview/sessions.db. Note: --project cannot be used with --source agentsview.

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