Write a clear, inclusive
Job Description Writer Skill

Write a clear, inclusive, and structured job description for any role. Use when asked to write a job description, job posting, JD, or job advert.
--- name: job-description-writer description: "Write a clear, inclusive, and structured job description for any role. Use when asked to write a job description, job posting, JD, or job advert. Produces a complete JD with role summary, responsibilities, requirements, and inclusive language review." --- # Job Description Writer Skill Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process. ## Required Inputs - **Job title and level** - **Team and reporting line** - **Top 5 things this person will actually do** - **Must-have requirements** (be ruthless — only what is truly required) - **Nice-to-have requirements** - **Salary range** (JDs with salary ranges get 30% more applicants) - **Location and remote policy** - **Company description** (2-3 sentences)
Overview
Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process.
Manual install (npx, ZIP)
npx skills add mohitagw15856/pm-claude-skills --skill job-description-writer -g -a claude-codemkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/mohitagw15856/pm-claude-skills/tar.gz/f6ca79348c55 \
| tar -xz -C ~/.claude/skills --strip-components=2 pm-claude-skills-f6ca79348c55/skills/job-description-writerNew-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/06306cad6109e762fbbc/job-description-writer.zip" -OutFile "$env:TEMP\job-description-writer.zip"; Expand-Archive "$env:TEMP\job-description-writer.zip" -DestinationPath "$HOME\.claude\skills" -ForceConnects with Agent Alley MCP · agentalley.io/mcp
Files included
SKILL.md3.0 KB
Read the files here
mohitagw15856/
Show the full text83 lines
Job Description Writer Skill
Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process.
Required Inputs
- Job title and level
- Team and reporting line
- Top 5 things this person will actually do
- Must-have requirements (be ruthless — only what is truly required)
- Nice-to-have requirements
- Salary range (JDs with salary ranges get 30% more applicants)
- Location and remote policy
- Company description (2-3 sentences)
Output Structure
[Job Title]
[Company] | [Location] | [Remote policy] | [Salary range]
About [Company] [2-3 sentences. Specific and honest — not marketing copy.]
The Role [3-4 sentences. What this person will own, why the role exists now, what success looks like in year one.]
What You Will Do [6-8 bullet points. Outcomes and responsibilities, not activities. Start each with an action verb. Most important first.]
What We Are Looking For
Must have (4-6 items only):
- [Requirement]
Nice to have (3-4 items):
- [Nice to have]
What We Offer [Compensation, benefits, development. Be specific.]
How to Apply [Clear instructions. What to send, where, timeline.]
Inclusive Language Review
Words to remove or replace:
| Original | Replace with | Why |
|---|---|---|
| "rockstar" | "experienced" | Gendered connotation |
| "ninja" | "skilled" | Same issue |
| "must have degree" | "relevant experience or qualification" | Excludes qualified non-graduates |
Requirement audit:
- Years of experience requirements flagged (screen out women and underrepresented groups disproportionately)
- Any requirements potentially discriminating against protected characteristics
Quality Checks
- Salary range included
- Must-haves genuinely essential (6 items max)
- Each responsibility starts with action verb
- Inclusive language review completed
- No years-of-experience requirements unless legally required
Anti-Patterns
- Do not include years-of-experience requirements unless legally necessary — they exclude qualified candidates and may create legal risk
- Do not list "nice to have" items in the requirements section — separate mandatory from desirable clearly
- Do not use gendered or exclusionary language — run the inclusive language check before finalising
- Do not write a responsibilities section with more than 8 items — prioritise the most important duties
- Do not omit compensation range where legally required or culturally expected — hiding salary deters qualified candidates
Example Trigger Phrases
- "Write a job description for a [role]"
- "Create an inclusive job posting for [role]"
- "Review and rewrite this JD: [paste]"
| 1 | |
| 2 | name job-description-writer |
| 3 | description "Write a clear, inclusive, and structured job description for any role. Use when asked to write a job description, job posting, JD, or job advert. Produces a complete JD with role summary, responsibilities, requirements, and inclusive language review." |
| 4 | |
| 5 | |
| 6 | # Job Description Writer Skill |
| 7 | |
| 8 | Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process. |
| 9 | |
| 10 | ## Required Inputs |
| 11 | **Job title and level** |
| 12 | **Team and reporting line** |
| 13 | **Top 5 things this person will actually do** |
| 14 | **Must-have requirements** (be ruthless — only what is truly required) |
| 15 | **Nice-to-have requirements** |
| 16 | **Salary range** (JDs with salary ranges get 30% more applicants) |
| 17 | **Location and remote policy** |
| 18 | **Company description** (2-3 sentences) |
| 19 | |
| 20 | ## Output Structure |
| 21 | |
| 22 | ### [Job Title] |
| 23 | **[Company] | [Location] | [Remote policy] | [Salary range]** |
| 24 | |
| 25 | **About [Company]** |
| 26 | [2-3 sentences. Specific and honest — not marketing copy.] |
| 27 | |
| 28 | **The Role** |
| 29 | [3-4 sentences. What this person will own, why the role exists now, what success looks like in year one.] |
| 30 | |
| 31 | **What You Will Do** |
| 32 | [6-8 bullet points. Outcomes and responsibilities, not activities. Start each with an action verb. Most important first.] |
| 33 | |
| 34 | **What We Are Looking For** |
| 35 | |
| 36 | Must have (4-6 items only): |
| 37 | [Requirement] |
| 38 | |
| 39 | Nice to have (3-4 items): |
| 40 | [Nice to have] |
| 41 | |
| 42 | **What We Offer** |
| 43 | [Compensation, benefits, development. Be specific.] |
| 44 | |
| 45 | **How to Apply** |
| 46 | [Clear instructions. What to send, where, timeline.] |
| 47 | |
| 48 | |
| 49 | |
| 50 | ### Inclusive Language Review |
| 51 | |
| 52 | **Words to remove or replace:** |
| 53 | |
| 54 | | Original | Replace with | Why | |
| 55 | |---|---|---| |
| 56 | | "rockstar" | "experienced" | Gendered connotation | |
| 57 | | "ninja" | "skilled" | Same issue | |
| 58 | | "must have degree" | "relevant experience or qualification" | Excludes qualified non-graduates | |
| 59 | |
| 60 | **Requirement audit:** |
| 61 | Years of experience requirements flagged (screen out women and underrepresented groups disproportionately) |
| 62 | Any requirements potentially discriminating against protected characteristics |
| 63 | |
| 64 | ## Quality Checks |
| 65 | [ ] Salary range included |
| 66 | [ ] Must-haves genuinely essential (6 items max) |
| 67 | [ ] Each responsibility starts with action verb |
| 68 | [ ] Inclusive language review completed |
| 69 | [ ] No years-of-experience requirements unless legally required |
| 70 | |
| 71 | ## Anti-Patterns |
| 72 | |
| 73 | [ ] Do not include years-of-experience requirements unless legally necessary — they exclude qualified candidates and may create legal risk |
| 74 | [ ] Do not list "nice to have" items in the requirements section — separate mandatory from desirable clearly |
| 75 | [ ] Do not use gendered or exclusionary language — run the inclusive language check before finalising |
| 76 | [ ] Do not write a responsibilities section with more than 8 items — prioritise the most important duties |
| 77 | [ ] Do not omit compensation range where legally required or culturally expected — hiding salary deters qualified candidates |
| 78 | |
| 79 | ## Example Trigger Phrases |
| 80 | "Write a job description for a [role]" |
| 81 | "Create an inclusive job posting for [role]" |
| 82 | "Review and rewrite this JD: [paste]" |
| 83 |
Details
- Updated
- Sep 23, 2026
- License
- MIT
- Stars on the repo
- ★ 1,395
- Checked
- Source
- mohitagw15856/pm-claude-skills ↗
- Creator
- mohitagw15856 · 193 listings
Made with job-description-writer


Similar skills
See all →
PromptAct as a LinkedIn messaging assistantCrafting linkedin messages to hiring managers
MCPProfessional, ethical HR partner for hiringHR pro
SkillBuilds end-to-end hiring packetsJob post builder
SkillEnd-to-end hiring signal compositeHiring signal outreach
SkillProduces a copy-ready clause about a company adding peoplePlaybook hiring surge
SkillProduces a copy-ready clause about a role a company isPlaybook job posting languageMore from mohitagw15856
SkillDesign a 360-degree feedback survey or write a structured360-Degree Feedback Template Skill
SkillDesign statistically rigorous A/B tests for product featuresA/B Test Planner Skill
SkillGenerate a WCAG 2.2 accessibility audit checklistAccessibility Audit Skill
SkillBuild a structured account plan for any key customerAccount Plan Skill
SkillOptimize an article for Answer Engine Optimization so AIAEO Optimizer Skill
SkillConduct a structured ethical review of an AI or ML featureAI Ethics Review Skill