plugins/hr-people-ops/skills/recruiting/job-description-writer/SKILL.md
Create inclusive, clear, and compelling job descriptions that attract diverse talent. Use this skill when writing new job postings, updating existing JDs, or improving hiring content. Activate when: job description, JD, job posting, hiring, role description, position opening, write JD.
npx skillsauth add latestaiagents/agent-skills job-description-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create inclusive, compelling job descriptions that attract top talent.
# [Role Title]
## About the Role
[2-3 sentences on impact and team context]
## What You'll Do
- [Responsibility 1 - action verb + outcome]
- [Responsibility 2]
- [Responsibility 3]
- [4-6 total responsibilities]
## What You'll Bring
**Required:**
- [Must-have skill/experience 1]
- [Must-have skill/experience 2]
- [Keep to 4-5 truly required items]
**Nice to Have:**
- [Preferred but not required 1]
- [Preferred but not required 2]
## What We Offer
- [Compensation range]
- [Key benefits]
- [Growth opportunities]
## About Us
[Brief company description + culture]
| Avoid | Use Instead | |-------|-------------| | "He will manage..." | "You will manage..." | | "Manpower" | "Workforce" or "Team" | | "Chairman" | "Chair" or "Chairperson" | | "Rockstar/Ninja/Guru" | "Expert" or "Specialist" |
| Avoid | Why | Use Instead | |-------|-----|-------------| | "Young and energetic" | Age discrimination | "Motivated" | | "Digital native" | Age bias | "Proficient with technology" | | "Culture fit" | Can mask bias | "Values alignment" | | "Must have 10+ years" | Often unnecessary | "Significant experience in..." |
Before (exclusionary):
Requirements:
- Bachelor's degree required
- 5+ years experience required
- Must be willing to work 60+ hours
After (inclusive):
Requirements:
- Bachelor's degree or equivalent experience
- Demonstrated expertise in [skill]
- Ability to meet project deadlines with occasional extended hours
## What You'll Do
- Design and implement [specific systems/features]
- Collaborate with [teams] to deliver [outcomes]
- Mentor junior engineers and contribute to technical decisions
- Participate in code reviews and improve engineering practices
## What You'll Bring
**Required:**
- Strong programming skills in [languages]
- Experience building [type of systems]
- Ability to break down complex problems
- Clear communication skills
**Nice to Have:**
- Experience with [specific technology]
- Contributions to open source
- Background in [related domain]
## What You'll Do
- Lead [function] initiatives that support [business goal]
- Partner with [stakeholders] to [achieve outcome]
- Develop and maintain [processes/relationships]
- Track and report on [metrics]
## What You'll Bring
**Required:**
- Experience in [function/industry]
- Strong analytical and communication skills
- Ability to manage multiple priorities
- Collaborative approach to problem-solving
## Compensation
- Base salary: $X - $Y (based on experience and location)
- Equity: [X shares / $Y value]
- Bonus: Up to X% of base salary
- Benefits: Health, dental, vision, 401k matching
Location: [Remote / Hybrid / On-site in City]
| Location | Requirement | |----------|-------------| | California | Must include salary range | | Colorado | Must include salary range | | New York City | Must include salary range | | Washington | Must include salary range | | Connecticut | Must provide on request |
Good: "Senior Software Engineer - Backend" Bad: "Code Wizard Level III"
development
Test skills for correct activation, content quality, and regression — both automated checks (frontmatter validity, lint) and manual verification (query-suite activation testing). Covers CI integration and how to catch skill regressions before users do. Use this skill when adding skills to a repo, setting up CI for a skill library, or debugging "the skill exists but doesn't work". Activate when: test skills, validate skills, skill CI, skill linting, skill activation test, skill regression.
documentation
Write the YAML frontmatter for a SKILL.md file so it activates reliably — name, description, and activation keywords that the model matches against. Covers length, tone, and the most common frontmatter mistakes. Use this skill when authoring a new skill, fixing a skill that isn't auto-activating, or reviewing skills for publication. Activate when: SKILL.md frontmatter, skill description, skill activation, skill YAML, write a skill, author a skill.
development
Design skills that fire at the right moment — neither over-eager (noise) nor under-eager (silent). Covers activation specificity, trigger phrases, disambiguation between overlapping skills, and debugging activation. Use this skill when multiple skills could fire on the same query, a skill never fires, or a skill fires too often. Activate when: skill won't activate, skill over-activates, overlapping skills, skill triggers, skill selection, skill disambiguation.
development
Structure SKILL.md content so the model reads just enough — concise summary up front, progressively deeper detail, examples on demand. Covers section ordering, length budgets, when to split into multiple skills. Use this skill when writing or refactoring a skill body, one skill has grown too long, or a skill is wordy but not useful. Activate when: SKILL.md structure, skill content, skill too long, split skill, progressive disclosure, skill body.