job-description-writer

$npx mdskill add mohitagw15856/pm-claude-skills/job-description-writer

Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process.

SKILL.md

.github/skills/job-description-writerView on GitHub ↗
---
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)

## 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

## Example Trigger Phrases
- "Write a job description for a [role]"
- "Create an inclusive job posting for [role]"
- "Review and rewrite this JD: [paste]"

More from mohitagw15856/pm-claude-skills

SkillDescription
360-feedback-templateDesign a 360-degree feedback survey or write a structured 360 feedback report. Use when asked to build a 360 feedback process, write 360 feedback for a colleague, design a feedback survey, or produce a feedback report. Produces either a complete survey instrument with rating scales and open-ended questions, or a structured narrative feedback report with themes, strengths, and development areas.
ab-test-plannerDesign statistically rigorous A/B tests for product features, UI changes, onboarding flows, and pricing experiments. Use when asked to set up an experiment, design an A/B test, calculate sample size, or interpret test results. Produces a complete test plan with hypothesis, variant definitions, sample size, duration estimate, guardrail metrics, and a results interpretation guide.
accessibility-auditGenerate a WCAG 2.2 accessibility audit checklist and remediation suggestions for any UI or design. Use when asked to audit for accessibility, check WCAG compliance, review a design for a11y issues, or create an accessibility remediation plan. Produces a prioritised checklist with pass/fail assessments and specific fixes.
account-planBuild a structured account plan for any key customer or target account. Use when asked to create an account plan, key account strategy, strategic account review, or territory plan. Produces a complete account plan with relationship map, growth opportunities, risks, and 90-day action plan.
aeo-optimizerOptimize an article for Answer Engine Optimization (AEO) — restructuring content so AI engines like ChatGPT, Perplexity, and Claude can extract, quote, and cite it. Rewrites headings as questions, drops 50-80 word answer capsules, audits paragraph length, and flags trust signals. Use when asked to AEO-optimize, make content AI-readable, improve AI citation chances, or adapt an article for answer engines.
ai-ethics-reviewConduct an ethical review of an AI or ML feature, model, or product. Use when asked to run an AI ethics review, assess AI risks, audit a model for bias, or produce an AI impact assessment. Produces a structured ethics review covering fairness, transparency, privacy, safety, accountability, and societal impact with prioritised mitigations.
ai-product-canvasStructure AI and ML product decisions with the rigour of any product decision. Use when building AI-powered features, evaluating LLM integrations, designing AI products, or assessing AI readiness. Produces a complete AI product canvas covering problem definition, model approach, data requirements, evaluation framework, UX design, responsible AI checklist, and launch monitoring plan.
ambiguity-resolverStructure vague opportunities and unclear briefs into actionable one-page problem statements. Use when asked to clarify a vague brief, frame an undefined problem, make sense of an unclear opportunity, or when the user says 'we need to figure out what to do about X' or 'I've been asked to look into Y'. Produces a structured problem brief with reframed questions, scoped boundaries, and a minimum viable research plan.
api-docs-writerWrite clear, developer-facing API documentation. Use when asked to document an API endpoint, write API reference docs, create a developer guide, or turn a raw spec/Postman collection into documentation. Produces endpoint documentation with descriptions, parameters, request/response examples, and error codes.
api-versioning-strategyWrite an API versioning strategy document for a service or API platform. Use when asked to define versioning policy, plan API deprecation, classify breaking changes, or document version lifecycle. Produces a complete versioning strategy with breaking-change classification table, deprecation timeline, migration guide template, and client communication template.