---
name: job-description-writer
description: "Writes a job description that leads with the real work, publishes the pay range, and honestly screens out the wrong candidates while attracting good ones. Use when a hiring manager needs to publish a job advert that is honest about the work and pay and attracts capable candidates who do not tick every box. Do not use for designing the interview questions or screening resumes. Related topics: Career, Writing, Communication."
---

# Job Description Writer

Writes a job description that leads with the real work, publishes the pay range, and honestly screens out the wrong candidates while attracting good ones.

## When to use

Use this skill when a hiring manager needs to publish a job advert that is honest about the work and pay and attracts capable candidates who do not tick every box. Do not use it for designing the interview questions or screening resumes.

## Workflow

1. Ask the user for each input listed below in a single message, skipping any they have already given. Where options are listed, offer them, but accept other answers too.
2. Open with the real day-to-day work in plain language before any company background.
3. Separate must-haves from nice-to-haves and cut any requirement that is not truly required.
4. State the salary range and benefits exactly as given.
5. Describe the difficult parts of the job and the working environment honestly.
6. Add what success looks like at six months and the hiring process with a realistic timeline.

## Inputs

- **The role** (free text, e.g. "Title and level")
- **What they would actually do all day** (longer free text)
- **Team and reporting line** (longer free text)
- **Genuinely required versus nice to have** (longer free text)
- **Salary range and benefits** (longer free text)
- **What working here is really like** (longer free text)

## Output

A ready-to-post job description with the work first, a short must-have list, nice-to-haves, pay, honest context, six-month success measures, and the process timeline.

## Prompt template

Fill the inputs into this template and follow it as the full instruction.

### Job description

Write a job description from the facts below.

- The role: {{The role}}
- What they would actually do all day: {{What they would actually do all day}}
- Team and reporting line: {{Team and reporting line}}
- Genuinely required versus nice to have: {{Genuinely required versus nice to have}}
- Salary range and benefits: {{Salary range and benefits}}
- What working here is really like: {{What working here is really like}}

Lead with the work. Nobody reads the paragraph about our mission first.

Cut requirements that are not requirements. Long lists mostly deter the candidates who would have been good but do not tick everything. Keep the must-haves to a short list and move the rest under nice to have.

Publish the range. Describe the difficult parts honestly, since hiring someone who would hate this job helps nobody. Include what success looks like at six months, and set out the hiring process with a realistic timeline. Use plain language and "you" to address the reader, and avoid filler such as "rockstar" or "fast-paced environment" without a concrete example.

## Pitfalls

- Listing every nice-to-have as a requirement, which deters strong candidates who would not apply.
- Hiding pay or the hard parts, which wastes everyone's time later.
- Filling the text with clichés such as rockstar or fast-paced instead of concrete detail.
