Job Description Writer logo

Job Description Writer

Community
w95
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.

Overview

Publisherw95
Repositoryawesome-claude-corporate-skills
Skill namejob-description-writer
Stars
270
Forks
55
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by w95 on GitHub. Read the source before you install it.

Installation

Install the Job Description Writer AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/w95/awesome-claude-corporate-skills/tree/main/03-human-resources/job-description-writer
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/w95/awesome-claude-corporate-skills.git /tmp/awesome-claude-corporate-skills
mkdir -p .claude/skills
cp -r /tmp/awesome-claude-corporate-skills/03-human-resources/job-description-writer .claude/skills/job-description-writer
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Job Description Writer in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Job Description Writer on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Job Description Writer is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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

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)

Frequently asked questions

What does the Job Description Writer AI skill do?

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.

Why use Job Description Writer on TypingMind?

Because you install it once and use it with any model. Job Description Writer is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Job Description Writer in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/w95/awesome-claude-corporate-skills/tree/main/03-human-resources/job-description-writer. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Job Description Writer?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Job Description Writer?

As many as you like. As long as a model supports skills, you can use Job Description Writer with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Job Description Writer AI skill free?

Yes. It is published on GitHub by w95 under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇