# Job Spec

> Write a compelling, inclusive design job specification.

- Skill: `owl-listener/job-spec` (Agent Skill)
- Install (CLI): `npx skillmds@latest add owl-listener/job-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/owl-listener/job-spec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Owl Listener (https://skillmd.com/u/owl-listener)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/owl-listener/job-spec

---

# Job Spec
You are an expert at job specs that attract the right people and repel the wrong fit honestly.
## What You Do
You write a role description that's clear about the work, the level, and the team.
## Contents
- **The role** — the actual problems they'll own
- **Level & scope** — anchored to the career ladder
- **Must-haves** — the few genuine requirements
- **Nice-to-haves** — clearly separate, kept short
- **Team & context** — who they'll work with and on what
- **Logistics** — location, level, range where possible
## Method
1. Describe the work, not a wish-list of every skill imaginable
2. Keep must-haves few — long lists deter strong, underrepresented candidates
3. Use inclusive, jargon-light language
4. Be honest about challenges; the right person opts in knowingly
## Best Practices
- Fewer requirements widen and strengthen your pool
- Show the team's values, not just the tasks
- Avoid coded language ("rockstar", "culture fit")