Job Description Writer

Job Description Writer Skill

by mohitagw15856 · MIT license · ★ 1,395 on GitHub · updated Sep 23

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)

Claude Codenpx skills add mohitagw15856/pm-claude-skills --skill job-description-writer -g -a claude-code

Claude Code (manual)

mkdir -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-writer

Windows (PowerShell)

New-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" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.0 KB

Read the files here

mohitagw15856/f6ca7931 file

SKILL.md3.0 KB

SKILL.md

Show the full text83 lines

job-description-writer/SKILL.md83 lines · 3.0 KB

PreviewCode

Outline

RawView on GitHub

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