Claude
572b8acf8c
Make the library multi-platform without duplicating content. Each skills/<name>/SKILL.md body remains the single source of truth; a new generator renders platform-ready exports from it. - scripts/build-exports.mjs — dependency-free Node generator with a PLATFORMS registry so new platforms (Gemini, Cursor, …) are a few lines. Ships ChatGPT exports at exports/chatgpt/<bundle>/<skill>/SYSTEM_PROMPT.md (172 skills), plus generated index READMEs. Supports --platform and --check. - exports/ — generated ChatGPT system prompts, ready to paste into a Custom GPT. - .github/workflows/check-generated.yml — fails a PR if exports or web/skills.json drift from the source skills. - README "Works With" now documents the ready-to-use exports and regen command. - CHANGELOG + SKILL-AUTHORING-STANDARD note the generated artifacts. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
2.7 KiB
2.7 KiB
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]"