Awesome-claude-corporate-skills job-description-writer
TRIGGER THIS when crafting job descriptions, posting new roles, defining position requirements, creating hiring briefs, updating JDs, or structuring role expectations. Creates compelling, inclusive, DEI-focused job descriptions with clear requirements, responsibilities, qualifications, salary transparency, and modern hiring language.
git clone https://github.com/w95/awesome-claude-corporate-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/w95/awesome-claude-corporate-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/03-human-resources/job-description-writer" ~/.claude/skills/w95-awesome-claude-corporate-skills-job-description-writer && rm -rf "$T"
03-human-resources/job-description-writer/SKILL.mdJob Description Writer
Overview
This skill helps HR professionals and hiring managers create effective, inclusive job descriptions that attract diverse talent, clearly communicate role expectations, and support equitable hiring processes. It ensures JDs include comprehensive role details, transparent compensation guidance, DEI language, and compliance-ready structure.
When to Use This Skill
- Creating new job descriptions for open positions
- Revising existing JDs to be more inclusive or accurate
- Developing hiring briefs for recruiter guidance
- Standardizing JD format across the organization
- Adding salary transparency and DEI elements to existing descriptions
- Ensuring JDs comply with accessibility and non-discrimination standards
- Creating role family templates for similar positions
Key Components
1. Core Structure Template
A well-organized JD should follow this proven framework:
- Position Title - Use inclusive, searchable language
- Department & Reporting Line - Clear organizational context
- Position Summary - 2-3 sentence overview of purpose
- Key Responsibilities - 5-8 main duties with impact metrics
- Required Qualifications - Only non-negotiable requirements (avoid "nice-to-haves")
- Preferred Qualifications - Open doors for diverse candidates
- Compensation & Benefits - Transparent salary bands, benefits overview
- Company Culture/DEI Statement - Commitment to inclusion
- Application Instructions - Accessibility accommodations offered
2. Inclusive Language Practices
- Replace "native English speaker" with "fluent in English"
- Use "years of experience" instead of "young and energetic"
- Avoid gendered terms (use "salesperson" not "salesman")
- Include "and more" in job duties to signal flexibility
- Emphasize "equivalent experience" to accept diverse backgrounds
- Replace ageist language (avoid "digital native," "rockstar," "ninja")
- Use "we encourage applications from underrepresented groups"
3. Responsibilities Writing
Each responsibility should follow the ACTION-IMPACT format:
- Start with action verb (design, develop, lead, analyze, coordinate)
- Include what you'll do and what business outcome results
- Example: "Lead cross-functional product team to deliver 3 major releases annually, impacting 50,000+ users"
- Quantify impact where possible (X% improvement, $X revenue, X users affected)
- Show growth potential and learning opportunities
4. Qualifications Strategy
- Required: Only list absolute deal-breakers (certifications, licenses, security clearance)
- Preferred: Use this section generously for nice-to-haves
- Equivalent Experience: Always include phrases like "or X years of related experience"
- Skills Over Credentials: Emphasize transferable skills, not just degree requirements
- Remove unnecessary credential inflation (many jobs don't truly need a 4-year degree)
5. Compensation Transparency
Current best practice requires including:
- Base salary range (when possible; check local legal requirements)
- Equity information (if applicable)
- Benefits highlights (healthcare, PTO, retirement, remote options)
- Total compensation approach
- Example format: "$95,000 - $145,000 based on experience and location"
- Note: Some regions require salary transparency; verify local laws
6. DEI & Belonging Statements
Include one or more of these elements:
- "We are an Equal Opportunity Employer"
- "We actively encourage applications from people of color, women, LGBTQ+ individuals, people with disabilities, and other underrepresented groups"
- "Accommodations available for candidates with disabilities"
- "We consider experience outside traditional pathways"
- "We provide [specific accommodations] to support your interview process"
7. Red Flags to Remove
- Unnecessary years of experience requirements (often exclude capable candidates)
- Gendered or ageist language
- Unclear or vague responsibilities
- "Multitasking" (most jobs involve multiple tasks; show what matters)
- "Startup mentality" or "willing to wear many hats" (exploitative language)
- Unrealistic "must-have" lists that exclude most candidates
- Passive language ("responsible for" instead of action verbs)
Workflow
Step 1: Gather Role Information
Interview hiring manager about:
- Core mission of the role
- Key metrics for success
- Team structure and reporting relationships
- Biggest challenges the person will face
- Growth/advancement opportunities
- Current skills gaps on team (to inform requirements)
- Budget, timeline, and hiring urgency
Step 2: Structure Responsibilities
- List 5-8 primary responsibilities
- Rank by importance and time allocation
- Convert to action-impact statements
- Add success metrics where applicable
- Group related duties for clarity
Step 3: Define Qualifications
- Separate true requirements from nice-to-haves
- Include equivalent experience language
- Highlight transferable skills
- Remove credential inflation
- Consider diverse pathways to the role
Step 4: Build Inclusive Elements
- Review language for bias
- Add DEI statement appropriate to company values
- Include accessibility accommodations
- Check that role appeals to broad talent pools
- Verify compensation transparency compliance
Step 5: Finalize & Review
- Read aloud for tone and clarity
- Ensure action verbs throughout
- Verify no discriminatory language
- Check for internal consistency
- Get manager approval before posting
Template Example
POSITION TITLE: Senior Product Manager, Financial Services DEPARTMENT: Product Management | Reports to: VP of Product POSITION SUMMARY Lead the design, development, and launch of innovative financial services products that serve our customer base of 500,000+ small businesses. You'll partner closely with engineering, design, and go-to-market teams to deliver products that are secure, intuitive, and compliant with regulatory requirements. KEY RESPONSIBILITIES - Lead the full product lifecycle for 2-3 financial services products from concept through post-launch, defining roadmaps that balance user needs, business objectives, and regulatory requirements - Conduct market research and user research (quarterly) to understand customer pain points, inform feature prioritization, and validate product-market fit assumptions - Collaborate with Engineering and Design to define product requirements, acceptance criteria, and success metrics; conduct code reviews and design reviews to ensure quality - Own go-to-market strategy and launch execution for new products, including positioning, pricing, marketing strategy, and sales enablement - Analyze product metrics and customer feedback; report quarterly on KPIs and iterate on strategy based on data insights - Build and maintain cross-functional relationships with Finance, Legal, and Compliance to navigate regulatory requirements for financial services - Mentor and develop 1-2 junior product managers; provide feedback and coaching on decision-making and stakeholder management REQUIRED QUALIFICATIONS - 5+ years of product management experience - Experience shipping at least 2 products (from concept through launch) - Strong analytical skills; proficiency with SQL, analytics tools, or data visualization - Excellent written and verbal communication skills - Ability to influence without direct authority PREFERRED QUALIFICATIONS - Experience in fintech, financial services, or heavily regulated industries - Background in user research or design thinking methodologies - Management experience and coaching of direct reports - Experience with marketplace or platform products - Proficiency with Figma, SQL, or JavaScript COMPENSATION & BENEFITS Salary range: $140,000 - $200,000 (based on experience, location, and background) Equity: 0.05% - 0.15% stock option grant Benefits: Full health insurance, $6,000 annual learning budget, 4 weeks PTO, 401(k) match, flexible work schedule, parental leave COMMITMENT TO DIVERSITY & INCLUSION We are an Equal Opportunity Employer. We actively encourage applications from women, people of color, LGBTQ+ individuals, people with disabilities, veterans, and other underrepresented groups. We recognize and value diverse experiences and perspectives as essential to our team's success. Accommodations: We provide interview accommodations including extended interview times, quiet spaces, video interviews, or interpreters upon request.
Best Practices
-
Specificity: Replace vague language with concrete examples
- Instead of: "Strong communication skills"
- Use: "Present product strategy to executive team and external partners monthly"
-
Inclusive Defaults: Assume diverse candidates and remove barriers
- Include "or equivalent experience" for all credentials
- Explain why requirements exist
- Accept certifications from international bodies
-
Accessibility: Make JDs accessible to all candidates
- Use simple, clear language
- Avoid acronyms without explanation
- Offer interview accommodations explicitly
- Provide alt-text for any images
- Use tools to check reading level
-
Compliance: Stay current with legal requirements
- Research salary transparency laws by location
- Verify non-discrimination language is appropriate
- Check for industry-specific compliance needs
- Update language based on recent case law
-
Testing: Validate your JDs
- Share with diverse people outside your org for feedback
- Test that your JD attracts diverse applicant pools
- Track whose applications you attract vs. who advances
- Update JD if you're not reaching target demographics
Common Mistakes to Avoid
- Credential Inflation: Requiring a degree when skills matter more
- Overuse of "Requirements": Everything should be a requirement or preferred, not both
- Passive Language: Focus on what the person will DO, not what they'll be responsible for
- Vague Success Metrics: Responsibilities without clear outcomes
- Missing Context: Assuming candidates know your industry/company
- Overlooking Accessibility: Posting only in one format or location
- Ignoring Feedback: Not updating JDs based on hiring outcomes
- Inconsistent Standards: Different JDs for similar roles
Tools & Resources
-
JD Review Checklist: Use before finalizing
- All responsibilities start with action verbs
- Compensation transparency included
- DEI statement present and authentic
- No discriminatory language
- Reading level appropriate (8th grade or lower)
- Accessibility accommodations mentioned
- Role appeals to diverse candidates
- Manager has reviewed and approved
-
Inclusive Language Alternatives:
- "Native English speaker" → "Fluent English"
- "Passionate" → "Committed to"
- "Ninja/Rockstar/Guru" → Actual job title
- "Young and dynamic" → "Energetic" or specific behaviors
- "Digital native" → "Proficient with [specific tools]"
-
Salary Transparency: Research regional laws (California, Colorado, New York, Washington all have requirements) and include bands when legally required
Measuring Success
- Applicant quality and relevance to role
- Diversity of applicant pool compared to market
- Time-to-hire
- Offer acceptance rate
- 90-day retention rate of new hires
- Feedback from hiring managers on JD usefulness
- Internal promotion rate for role (if applicable)