hermes

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.

context

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.

task

Review these instructions.

current instructions

Only if [PAIN_POINTS] is given:

pain points

  1. 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.
  1. Link each pain point to the line that causes it or the gap that allows it.
  2. 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.
  3. Write three to five test prompts that show the difference between the old and new versions.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install review-custom-instructions --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill review-custom-instructions -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the prompting plugin
claude plugin install hodios-prompting@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Assistant setup
PromptAssistant setup

Write 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-instructions
PromptAssistant setup

Build 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-instructions
PromptAssistant setup

Write 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-profile
PromptPrompt engineering

Compress 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-prompt
RuleAssistant setup

Candid 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-rules
PromptAssistant setup

Map 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