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.
Most assistants let people save standing instructions: a short profile of who they are and how they want answers. Most people write adjectives ("be concise, be smart") that change little. Instructions work when they describe behaviour the assistant can follow and the user can notice: "Lead with the answer in one or two sentences, then details only if they change what I do."
Only if [PREFERENCES] is given:
Only if [TOOL] is given: Tool:
- If the input says nothing about what the user does or uses the assistant for, ask for that in one question and stop. Otherwise write the "About me" part: the facts about the user that should change answers (role, expertise, recurring tasks, location or units if relevant, language). Leave out what would not change an answer.
- Write the "How to respond" part as short, specific behaviours:
- Default length and structure, and when to go longer.
- Tone and register.
- How to treat uncertainty, errors and disagreement.
- When to ask a clarifying question versus making a stated assumption.
- Formatting habits (lists, tables, code, headings) for the user's typical use. Turn each pet peeve into the positive behaviour that replaces it ("No preamble" becomes "Start with the answer").
- Resolve conflicts. If two preferences pull against each other (always short, always thorough), write a rule for when each applies, and mention it in the notes.
- Fit the tool. Some assistants have two fields (one about you, one for how to respond); others have a single instructions field. If the user says theirs has one field, write one block with both parts as labelled paragraphs. Otherwise write two parts and note that they can also be pasted together into a single field. If a character limit is given, stay well under it, since your count is an estimate. If not, keep each part under about 1,500 characters and say so.
- Explain each line briefly so the user can edit it.
- Give three test prompts the user can try before and after, each with what should change.
- Every line must be something the assistant can do and the user can observe. No adjectives on their own.
- Do not include sensitive data that the assistant does not need: passwords, ID or account numbers, full home address, other people's personal details, or health information unrelated to how answers should be given. If the input contains any, leave it out and list it under "Left out".
- Write in second person to the assistant ("Start with...", "When I ask for code...").
- Use the user's language and spelling conventions.
Instructions
"About me" and "How to respond", each in its own fenced code block, ready to paste, followed by its approximate length in characters. For a single-field tool, one fenced block with both parts as labelled paragraphs.
Why each line
Bullets, one per line of the instructions.
Left out
Anything removed and why, or "Nothing".
Try it
Three bullets: test prompt and what should change.
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
- made for
- Anyone, personal use
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- 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 write-custom-instructions --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-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 setupBuild 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-instructionsCandid 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-rulesSkimmable
Shapes any answer for skimming, from bolded key sentences and short paragraphs to headed sections, bullets first, and a strict table-first layout.
skimmablePlain language
Lowers the reading effort of any answer, from swapping jargon for everyday words to a grade 6 reading level, keeping every fact accurate. Use for the general public or second-language readers.
plainMap 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-casesReview 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.
review-custom-instructions