mohitagw15856
036511ab3e
Broadens both reach (more tools) and content types (an MCP server), continuing the multi-platform story. Windsurf + Aider: - build-exports.mjs gains two platforms: exports/windsurf/*.md (workspace rules, trigger: model_decision) and exports/aider/*.md (conventions for `aider --read`). Now 5 platforms (ChatGPT, Gemini, Cursor, Windsurf, Aider). - install.sh + bin/cli.mjs install both (windsurf -> .windsurf/rules, aider -> .aider/skills with a --read hint); generated README index is excluded from copies. - One-line windsurf-install.sh / aider-install.sh wrappers for parity. MCP server (new content type): - mcp/server.mjs — zero-dependency stdio MCP server exposing list_skills, search_skills, get_skill. Published as a second bin (pm-claude-skills-mcp). Logs to stderr; reads bundled skills/ at startup. mcp/README.md documents client config. Also: README hero "See it in action" demo placement (ready to swap in a GIF; recording guide in web/docs-assets/README.md), Works-With table + exports + install docs updated, CHANGELOG Unreleased. package.json files/bin updated. Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px Co-authored-by: Claude <noreply@anthropic.com>
78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
# 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]"
|