Review custom instructions
Reviews existing custom or project instructions for an AI assistant, finds conflicts, vague rules, outdated facts and missing context, and returns a tighter version with test prompts.
Custom instructions grow by accretion: a line added after each annoying answer, a job title from two roles ago, a rule copied from a blog post. Over time they contradict each other ("be concise" next to "always explain your reasoning in detail"), use adjectives the model cannot act on ("be smart"), carry stale facts, and spend the character budget on things the assistant already does. Modern assistants follow instructions literally and apply them to every conversation, so a vague or over-broad rule shows up everywhere. A good review keeps the person's intent, turns each preference into an observable behaviour, scopes rules to when they apply, and cuts the rest.
Review these instructions.
Only if [PAIN_POINTS] is given:
- Read every line and classify any problem as one of:
- conflict: two lines that cannot both be followed, or that pull in opposite directions;
- vague: an adjective or goal with no behaviour attached ("be thorough", "be smart");
- over-broad: a rule that should apply only in some situations but is stated for all;
- outdated or unverifiable: dates, roles, tools, versions, projects or facts that look stale;
- redundant: repeats another line or what assistants do by default;
- counterproductive: shouting, threats, or rules likely to cause over-application;
- missing: context the pain points or the rest of the instructions suggest is needed but absent.
- Link each pain point to the line that causes it or the gap that allows it.
- Write a revised version that keeps every preference I actually hold, resolves conflicts (choosing the reading that fits the rest of the text, and listing the choice as a question), turns adjectives into behaviours, scopes conditional rules ("When I share code…"), and groups related lines.
- Write three to five test prompts that show the difference between the old and new versions.
- Do not add preferences I did not express. Put suggested additions in Findings as "missing", for me to accept or not.
- Do not silently update facts. Ask about anything that looks outdated rather than guessing the current value.
- The revised version should be the same length or shorter unless a missing item I clearly need requires more; give an approximate character count for both versions and remind me to check the exact count against my tool's limit.
- Keep my voice and my wording where it already works.
- Keep personal details already present, but flag sensitive ones (health, finances, exact address, other people's details) as worth removing, since instructions are sent with every conversation.
Findings
A table: Line (quoted, shortened) | Problem | Why it matters | Fix.
Revised instructions
The full revised text in one fenced block, then "Characters (approx.): old N → new M".
Removed
Bullets of what was cut and why, one line each.
Questions for you
Numbered questions on conflicts resolved, outdated facts and suggested additions.
Try it
Test prompts, each with what should change in the answer.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Prompting and assistants
- category
- Assistant setup
- level
- Beginner
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install review-custom-instructions --target claude-codenpx skills add hermes-hq/hodios-dist --skill review-custom-instructions -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-prompting@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Assistant setupWrite custom instructions
Writes personal custom instructions for an AI assistant from your role, preferences and pet peeves, turning them into specific behaviours, with test prompts to check the difference.
write-custom-instructionsBuild project instructions
Writes project-level instructions and a knowledge-file outline for a recurring project in an AI assistant, with a playbook for each repeated task and test prompts.
build-project-instructionsWrite a memory profile for your assistant
Writes a concise profile of your standing preferences, context and facts for an AI assistant's memory, flags what to leave out for privacy and what goes stale, and gives a review routine.
write-memory-profileCompress a prompt
Shortens a long prompt while preserving its behaviour, maps every original instruction to where it now lives, reports the real size reduction and lists test inputs to check nothing changed.
compress-promptCandid feedback rules
Standing rules that make an assistant candid - no flattery, real disagreement when warranted, stated confidence, admitted uncertainty, and position changes only for good reasons.
candid-feedback-rulesMap where AI helps in your work
Maps a person's recurring work tasks to where an AI assistant helps, what to keep human, the prompt or setup for each and a check step, ranked by the time it could save.
map-ai-use-cases