Home
cd ../playbooks
HR & RecruitingAdvanced

Job Description Writer

Generate professional, inclusive job descriptions that attract qualified candidates for any role.

10 minutes
By communitySource
#job-description#hiring#recruitment

Your job description says 'rockstar developer wanted' and lists 25 'required' skills nobody has. Research shows gendered language and inflated requirements cut your applicant pool in half — especially among underrepresented candidates who won't apply unless they meet 100% of criteria.

Who it's for: HR professionals writing inclusive job postings, hiring managers attracting diverse candidate pools, talent acquisition teams improving application rates, companies auditing existing JDs for bias, anyone whose job posting got zero qualified applicants

Example

"Write an inclusive job description for a Full-Stack Developer" → Professional JD with bias-free language, realistic requirements separated into must-have vs. nice-to-have, clear growth trajectory, compensation transparency, and accessibility considerations — tested against inclusion checklists

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add job-description
# Job Description Generator

Generate professional, inclusive job descriptions that attract qualified candidates.

## Overview

This workflow helps HR professionals and hiring managers create comprehensive job postings that:
- Clearly communicate role expectations
- Use inclusive, bias-free language
- Follow industry best practices
- Attract diverse, qualified candidates

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Generate professional, inclusive job descriptions that attract qualified candidates.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/Documents/JobDescription

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ~/Documents/JobDescription/

Step 3: Start Working

cd ~/Documents/JobDescription
claude

How to Use

Provide the following information:

  1. Job Title: The position name
  2. Department: Team or department
  3. Level: Entry, Mid, Senior, Lead, Director, etc.
  4. Employment Type: Full-time, Part-time, Contract
  5. Location: On-site, Remote, Hybrid
  6. Key Responsibilities: What the role will do
  7. Requirements: Must-have qualifications
  8. Nice-to-haves: Preferred qualifications
  9. Company Info: Brief about the company (optional)

Best Practices

Language Guidelines

  • Use "you" instead of "the ideal candidate"
  • Avoid gendered language (he/she → they)
  • Remove unnecessary jargon
  • Be specific about requirements vs. nice-to-haves
  • Include salary range when possible (improves applications by 30%)

Red Flags to Avoid

  • "Rockstar" / "Ninja" / "Guru" → Use "Expert" or "Specialist"
  • "Fast-paced environment" → Be specific about workload
  • Excessive requirements → Limit to 5-7 must-haves
  • Vague responsibilities → Use measurable outcomes

Inclusive Language

Instead of Use
"Young and energetic" "Motivated and enthusiastic"
"Native English speaker" "Fluent in English"
"Cultural fit" "Values alignment"
"Digital native" "Proficient with digital tools"

Examples

Example Request

Create a job description for:
- Title: Senior Frontend Developer
- Department: Engineering
- Level: Senior (5+ years)
- Type: Full-time, Remote
- Tech stack: React, TypeScript, GraphQL
- Team size: 8 engineers
- Company: B2B SaaS startup, Series B

Example Output

# Senior Frontend Developer

Limitations

  • Cannot guarantee legal compliance (have HR/legal review)
  • Salary benchmarks may not reflect local markets
  • Industry-specific requirements need domain input
  • Cannot verify company information provided

$Related Playbooks

HR & Recruiting

Job Description Generator

Generate comprehensive job descriptions, hiring plans, interview rubrics, and organizational materials for any role.

5 minutes
Beginner
HR & Recruiting

Minimalist Company Values

Define 3-5 non-obvious company values that repel the wrong people and attract the right ones — before you hire anyone. Based on Sahil Lavingia's approach at Gumroad.

5 minutes
Beginner
HR & Recruiting

People Analytics Reporter

Generate headcount, attrition, diversity, and organizational health reports

10 minutes
Intermediate
HR & Recruiting

Recruiting Pipeline Tracker

Track recruiting pipeline stages, candidate status, conversion rates, and hiring metrics

10 minutes
Intermediate
HR & Recruiting

Workflows Gap Analysis

Assess workforce capabilities against strategic needs, identify skill gaps, and build targeted development and hiring plans.

10 minutes
Intermediate
HR & Recruiting

Compensation Analysis & Recommendations

Analyze compensation data for market alignment, internal equity, and pay gap identification with adjustment recommendations.

10 minutes
Intermediate
HR & Recruiting

Diversity & Inclusion Reporting

Generate diversity and inclusion reports with demographic analysis, representation metrics, and progress tracking against DEI goals.

10 minutes
Intermediate
HR & Recruiting

Employee Communication Campaigns

Design internal communication campaigns for organizational changes, new initiatives, and employee engagement with multi-channel messaging.

10 minutes
Intermediate
HR & Recruiting

Employee Handbook & Policy Updates

Draft and update employee handbook sections and HR policies with consistent formatting, clear language, and compliance alignment.

10 minutes
Intermediate
HR & Recruiting

Exit Interview Analysis

Analyze exit interview data to identify attrition themes, department patterns, and actionable retention recommendations.

10 minutes
Intermediate
HR & Recruiting

Interview Scorecard Builder

Generate structured interview question banks with competency-based scorecards for consistent, bias-reduced candidate evaluation.

5 minutes
Beginner
HR & Recruiting

Job Description & Role Documentation

Create comprehensive job descriptions with screening criteria, interview questions, and evaluation rubrics that attract qualified candidates.

5 minutes
Beginner

Browse all HR & Recruiting playbooks →