hermes

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.

context

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."

about me

Only if [PREFERENCES] is given:

preferences

Only if [TOOL] is given: Tool:

task
  1. 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.
  2. 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").
  1. 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.
  2. 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.
  3. Explain each line briefly so the user can edit it.
  4. Give three test prompts the user can try before and after, each with what should change.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-custom-instructions --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-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

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
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
StyleOutput styles

Skimmable

Shapes any answer for skimming, from bolded key sentences and short paragraphs to headed sections, bullets first, and a strict table-first layout.

skimmable
StyleOutput styles

Plain 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.

plain
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
PromptAssistant setup

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.

review-custom-instructions