mohitagw15856
05b6d799f0
Three more learnings from alirezarezvani/claude-skills, applied: 1. SkillCheck validator (scripts/skillcheck.mjs) — validates every SKILL.md against the authoring standard (frontmatter, name/folder match, trigger + produces clauses, required headings) plus tier referential integrity. Errors fail CI; --strict fails on warnings too. New skillcheck.yml workflow and a SkillCheck status badge in the README. Current: 0 errors / 14 advisory warnings across 172 skills. 2. Cursor export platform — build-exports.mjs now generates exports/cursor/<bundle>/<skill>/<skill>.mdc rule files. The PLATFORMS registry now supports per-skill filenames (file as a function). 3. Per-agent installers — scripts/install.sh unifies install for claude/hermes/codex/openclaw/cursor (--link, --target, --dry-run, --list). Curl-able one-liners codex-install.sh, openclaw-install.sh, and cursor-install.sh clone the library and install in a single command. README documents the one-line installs and Cursor exports; CHANGELOG and the authoring standard updated. Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px Co-authored-by: Claude <noreply@anthropic.com>
84 lines
3.0 KiB
Plaintext
84 lines
3.0 KiB
Plaintext
---
|
|
description: "Write a clear, inclusive, and structured job description for any role. Use when asked to write a job description, job posting, JD, or job advert. Produces a complete JD with role summary, responsibilities, requirements, and inclusive language review."
|
|
globs:
|
|
alwaysApply: false
|
|
---
|
|
|
|
# Job Description Writer Skill
|
|
|
|
Writes complete, inclusive job descriptions that attract the right candidates and reduce bias in the hiring process.
|
|
|
|
## Required Inputs
|
|
- **Job title and level**
|
|
- **Team and reporting line**
|
|
- **Top 5 things this person will actually do**
|
|
- **Must-have requirements** (be ruthless — only what is truly required)
|
|
- **Nice-to-have requirements**
|
|
- **Salary range** (JDs with salary ranges get 30% more applicants)
|
|
- **Location and remote policy**
|
|
- **Company description** (2-3 sentences)
|
|
|
|
## Output Structure
|
|
|
|
### [Job Title]
|
|
**[Company] | [Location] | [Remote policy] | [Salary range]**
|
|
|
|
**About [Company]**
|
|
[2-3 sentences. Specific and honest — not marketing copy.]
|
|
|
|
**The Role**
|
|
[3-4 sentences. What this person will own, why the role exists now, what success looks like in year one.]
|
|
|
|
**What You Will Do**
|
|
[6-8 bullet points. Outcomes and responsibilities, not activities. Start each with an action verb. Most important first.]
|
|
|
|
**What We Are Looking For**
|
|
|
|
Must have (4-6 items only):
|
|
- [Requirement]
|
|
|
|
Nice to have (3-4 items):
|
|
- [Nice to have]
|
|
|
|
**What We Offer**
|
|
[Compensation, benefits, development. Be specific.]
|
|
|
|
**How to Apply**
|
|
[Clear instructions. What to send, where, timeline.]
|
|
|
|
---
|
|
|
|
### Inclusive Language Review
|
|
|
|
**Words to remove or replace:**
|
|
|
|
| Original | Replace with | Why |
|
|
|---|---|---|
|
|
| "rockstar" | "experienced" | Gendered connotation |
|
|
| "ninja" | "skilled" | Same issue |
|
|
| "must have degree" | "relevant experience or qualification" | Excludes qualified non-graduates |
|
|
|
|
**Requirement audit:**
|
|
- Years of experience requirements flagged (screen out women and underrepresented groups disproportionately)
|
|
- Any requirements potentially discriminating against protected characteristics
|
|
|
|
## Quality Checks
|
|
- [ ] Salary range included
|
|
- [ ] Must-haves genuinely essential (6 items max)
|
|
- [ ] Each responsibility starts with action verb
|
|
- [ ] Inclusive language review completed
|
|
- [ ] No years-of-experience requirements unless legally required
|
|
|
|
## Anti-Patterns
|
|
|
|
- [ ] Do not include years-of-experience requirements unless legally necessary — they exclude qualified candidates and may create legal risk
|
|
- [ ] Do not list "nice to have" items in the requirements section — separate mandatory from desirable clearly
|
|
- [ ] Do not use gendered or exclusionary language — run the inclusive language check before finalising
|
|
- [ ] Do not write a responsibilities section with more than 8 items — prioritise the most important duties
|
|
- [ ] Do not omit compensation range where legally required or culturally expected — hiding salary deters qualified candidates
|
|
|
|
## Example Trigger Phrases
|
|
- "Write a job description for a [role]"
|
|
- "Create an inclusive job posting for [role]"
|
|
- "Review and rewrite this JD: [paste]"
|