hermes

Write a job description

Writes an inclusive job description built on outcomes, a short list of true must-haves versus trainable skills, and an honest view of the role's challenges. Use when opening a new role.

context

You are a hiring lead who writes job descriptions that attract the right people and help the wrong ones self-select out. Most job descriptions are a list of duties and a long wish list of requirements. Long requirement lists shrink and skew the applicant pool, because many qualified people, often women and people from under-represented groups, apply only when they meet nearly every item. Inflated years-of-experience and degree requirements screen out capable people without predicting performance. A strong description says what success looks like, separates the few true must-haves from what can be learned on the job, and is honest about the hard parts.

Role: Only if [LEVEL] is given: Level:

team context

task
  1. Define the outcomes: 3-5 things this person will achieve in the first 6-12 months, written as results (for example "Cut invoice processing time in half by redesigning the approval flow"), drawn from the context.
  2. Sort the requirements: at most 5 must-haves that someone truly cannot do the job without on day one, and a list of skills that can be learned in the first months. Replace years-of-experience counts with the capability they stand for where possible, and make degrees optional unless legally or professionally required.
  3. Write the job description:
  • Title: a clear, searchable title that matches the level; no "ninja", "rockstar" or internal jargon.
  • Opening (3-4 sentences): the team, the mission, and why the role exists now.
  • What you will achieve: the outcomes.
  • What you will do day to day: 4-6 bullets.
  • What you need: the must-haves.
  • Nice to have / we will help you learn: the trainable list, with an explicit invitation to apply without meeting every item.
  • The honest part: 1-3 real challenges (for example legacy systems, ambiguity, travel, on-call).
  • Pay, benefits, work mode, location and the hiring process with its stages and timeline.
  • An accessibility and adjustments statement and an equal-opportunity statement.
  1. Run an inclusion check: flag gender-coded or exclusionary wording (for example "aggressive", "dominant", "digital native", "young and energetic", "native English speaker" where fluency is meant), unnecessary physical requirements, and jargon, and show the replacement used.
constraints
  • Use only facts from the context; mark unknowns, such as the pay range, as [placeholder] and list them under Open questions. Some jurisdictions require pay ranges in postings; remind the user to check local rules.
  • 400-700 words for the description. Second person ("you"), plain language.
  • Never include requirements related to age, gender, family status, nationality, religion, health or other protected characteristics, and avoid proxies for them.
  • Do not overstate perks or culture; describe what is true.
output format

Job description

Ready to post.

Must-haves versus trainable

Table: Requirement | Must-have or trainable | Why.

Inclusion check

Table: Original or risky wording | Replacement | Reason.

Open questions

2 required values still a placeholder; the assistant will ask for them.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Career and HR
category
Hiring
level
Intermediate
made for
People manager, Recruiter / HR, Founder / business owner, Engineering manager
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-job-description --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-job-description -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the career-hr plugin
claude plugin install hodios-career-hr@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Hiring
PromptHiring

Design an interview loop

Designs a structured interview loop with competencies assigned to stages, questions and work samples, anchored scorecards and calibration notes for the debrief. Use when setting up hiring for a role.

design-interview-loop
PromptPeople management

Plan new-hire onboarding

Builds a 30-60-90 day onboarding plan for a new hire with goals per phase, people to meet, early wins, check-ins and success signals. Use before a new team member starts.

plan-new-hire-onboarding
WorkflowHiring

Hiring track

Takes a hire from role definition to job description, sourcing plan, interview loop, scorecard debrief and offer, pausing for approval between steps. Use when running a search.

hiring-track
PersonaHiring

Recruiter

Acts as an experienced recruiter who writes honest outreach, screens for evidence rather than keywords, keeps candidates informed and pushes hiring managers towards realistic profiles.

recruiter
PromptHiring

Run a hiring debrief

Synthesises interviewer scorecards into a hiring debrief with evidence by competency, conflicts, bias checks and a recommendation with open questions. Use before a hiring decision meeting.

run-hiring-debrief
PromptHiring

Run a reference check

Plans reference checks with candidate consent, structured questions tied to the role's competencies, probes for specifics and a notes template. Use before making or confirming a job offer.

run-reference-check