Agent skill

Job Description Writer

by w95 in w95/awesome-claude-corporate-skills

TRIGGER THIS when crafting job descriptions, posting new roles, defining position requirements, creating hiring briefs, updating JDs, or structuring role expectations.

MITAuto-check passedBusiness, Finance & HR

Install Job Description Writer

skills CLI
$ npx skills add w95/awesome-claude-corporate-skills --skill job-description-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install w95/awesome-claude-corporate-skills job-description-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/w95/awesome-claude-corporate-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/03-human-resources/job-description-writer .claude/skills/job-description-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
job-description-writer
GitHub stars
244
Token cost
~3k tokens
SKILL.md length
1,025 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

TRIGGER THIS when crafting job descriptions, posting new roles, defining position requirements, creating hiring briefs, updating JDs, or structuring role expectations.

  • Works in 12 steps: Core Structure Template → Inclusive Language Practices → Responsibilities Writing → …
  • THIS when crafting job descriptions
  • SKILL.md covers Overview, When to Use This Skill, Key Components and Workflow, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Job Description Writer is an agent skill from w95/awesome-claude-corporate-skills. 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.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Recruiting and HR. The repository describes itself as: 166 production-ready Claude AI skills organized by corporate role — executive leadership, finance, HR, marketing, sales, legal, operations, engineering, product, data, customer…. The licence is MIT.

When your agent uses it

  • THIS when crafting job descriptions
  • Posting new roles
  • Defining position requirements
  • Creating hiring briefs

Example prompts

  • “/job-description-writer”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Core Structure Template
  2. Inclusive Language Practices
  3. Responsibilities Writing
  4. Qualifications Strategy
  5. Compensation Transparency
  6. DEI & Belonging Statements
  7. Red Flags to Remove
  8. Gather Role Information
  9. Structure Responsibilities
  10. Define Qualifications
  11. Build Inclusive Elements
  12. Finalize & Review

What it can do on your machine

Read from SKILL.md and the folder at commit 78dbc7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Job Description Writer loads about 3k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 1,025 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from w95/awesome-claude-corporate-skills at commit 78dbc7c, republished under its MIT licence (© w95). 1,025 words, ~2,971 tokens.

Download SKILL.mdSave it as .claude/skills/job-description-writer/SKILL.md (or your agent's skills folder).
name
job-description-writer
description
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.

Job 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
Show full SKILL.md (420 more words)Show less
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

  1. Specificity: Replace vague language with concrete examples

    • Instead of: "Strong communication skills"
    • Use: "Present product strategy to executive team and external partners monthly"
  2. Inclusive Defaults: Assume diverse candidates and remove barriers

    • Include "or equivalent experience" for all credentials
    • Explain why requirements exist
    • Accept certifications from international bodies
  3. 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
  4. 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
  5. 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)

© w95, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in 03-human-resources/job-description-writer of w95/awesome-claude-corporate-skills.

Open the folder on GitHubat commit 78dbc7c

Compare with similar skills

Job Description Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Job Description Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Job Description Writer this skillw95/awesome-claude-corporate-skills244—~3kAutomated safety check: PassMIT
Get Jobagentenatalie/get-job.skill632—~1.7kAutomated safety check: PassCC-BY-NC-ND-4.0
Resume Reviewerweeelin98/ResumeDom173—~2.4kAutomated safety check: PassNone
Build Resume Portfolio Sitetao943/build-resume-portfolio-site195—~5.8kAutomated safety check: PassNone
Cyber Resume Reviewermubix/cyber-resume-reviewer-skill184—~2.9kAutomated safety check: PassMIT
Repo To Resume TailorSsabby1/repo-to-resume-tailor127—~1.8kAutomated safety check: PassMIT

Similar skills

  • Get Job

    agentenatalie/get-job.skill

    实习.skill / get-job.skill:从岗位调研、简历改写到分轮次面试准备的全流程求职 skill。适合找工作、投实习、校招、秋招、春招、暑期实习、社招、跳槽、转行、跨专业求职、留学生求职,以及产品经理、运营、市场、咨询、AI 产品、AI Coding、数据分析、技术岗等目标岗位准备。

    632 GitHub stars~1.7k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Resume Reviewer

    weeelin98/ResumeDom

    Build, assess, review, and tailor evidence-backed US-market technology resumes for computer-science interns and new graduates.

    173 GitHub stars~2.4k tokensUpdated 15 days ago
    Business, Finance & HRAuto-check passed
  • Build Resume Portfolio Site

    tao943/build-resume-portfolio-site

    A skill your agent uses when turning resume materials and an optional job description into verified, approved content and a runnable React + Vite resume or portfolio site, or when redesigning an…

    195 GitHub stars~5.8k tokensUpdated 10 days ago
    Business, Finance & HRAuto-check passed
  • Cyber Resume Reviewer

    mubix/cyber-resume-reviewer-skill

    Review, tailor, score, or rewrite IT and cybersecurity resumes.

    184 GitHub stars~2.9k tokensUpdated 20 days ago
    Business, Finance & HRAuto-check passed
  • Repo To Resume Tailor

    Ssabby1/repo-to-resume-tailor

    Analyze a full code repository and generate one resume-ready project description grounded in repository evidence.

    127 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates.

    6.1k GitHub starsUsed in 1 repo~1.9k tokens
    Business, Finance & HRAuto-check passed

More from w95/awesome-claude-corporate-skills

All 41 skills in this repo
  • Data Context Extractor

    w95/awesome-claude-corporate-skills

    Generate or improve a company-specific data analysis skill by extracting tribal knowledge from analysts.

    244 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Competitive Analysis

    w95/awesome-claude-corporate-skills

    Framework for competitive landscape analysis across any industry.

    244 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed
  • Account Research

    w95/awesome-claude-corporate-skills

    Research a company using Common Room data. An agent skill from w95/awesome-claude-corporate-skills.

    244 GitHub stars~1.5k tokensUpdated 7 mo ago
    Auto-check passed
  • Call Prep

    w95/awesome-claude-corporate-skills

    Prepare for a customer or prospect call using Common Room signals.

    244 GitHub stars~1.5k tokensUpdated 7 mo ago
    Auto-check passed
  • Compose Outreach

    w95/awesome-claude-corporate-skills

    Generate personalized outreach messages using Common Room signals.

    244 GitHub stars~1.4k tokensUpdated 7 mo ago
    Auto-check passed
  • SQL Queries

    w95/awesome-claude-corporate-skills

    Write correct, performant SQL across all major data warehouse dialects (Snowflake, BigQuery, Databricks, PostgreSQL, etc.).

    244 GitHub starsUsed in 3 repos~2.8k tokens
    Auto-check passed

Questions about Job Description Writer

What does Job Description Writer do?

TRIGGER THIS when crafting job descriptions, posting new roles, defining position requirements, creating hiring briefs, updating JDs, or structuring role expectations. Job Description Writer is an agent skill from w95/awesome-claude-corporate-skills. TRIGGER THIS when crafting job descriptions, posting new roles, defining position requirements, creating hiring briefs, updating JDs, or structuring role expectations.

When should I use Job Description Writer?

Job Description Writer fits situations like: THIS when crafting job descriptions; posting new roles; defining position requirements; creating hiring briefs.

How do I install Job Description Writer in Claude Code?

Run `npx skills add w95/awesome-claude-corporate-skills --skill job-description-writer -a claude-code`. Or copy the skill folder (03-human-resources/job-description-writer in w95/awesome-claude-corporate-skills) into .claude/skills/job-description-writer in your project. Claude Code loads it when a task matches its description.

How do I install Job Description Writer in Codex?

Run `npx skills add w95/awesome-claude-corporate-skills --skill job-description-writer -a codex`. Or copy the skill folder (03-human-resources/job-description-writer in w95/awesome-claude-corporate-skills) into .agents/skills/job-description-writer in your project. Codex loads it when a task matches its description.

Can I use Job Description Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add w95/awesome-claude-corporate-skills --skill job-description-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/job-description-writer, .gemini/skills/job-description-writer, .github/skills/job-description-writer and .opencode/skills/job-description-writer in your project.

What does Job Description Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Job Description Writer is instructions for the agent only.

Does Job Description Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Job Description Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Job Description Writer use?

Job Description Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Job Description Writer use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Job Description Writer?

Skills that share tags, products or a category with Job Description Writer: Get Job (agentenatalie/get-job.skill, 632 stars), Resume Reviewer (weeelin98/ResumeDom, 173 stars), Build Resume Portfolio Site (tao943/build-resume-portfolio-site, 195 stars) and Cyber Resume Reviewer (mubix/cyber-resume-reviewer-skill, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Job Description Writer?

w95 (a GitHub user) maintains it in w95/awesome-claude-corporate-skills, which has 244 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on February 26, 2026.

Source: w95/awesome-claude-corporate-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.