skills/by-role/recruiter/job-description/SKILL.md
Write a performance-based job description. Use when the user says "write a JD", "draft a job posting", "create a job description", "help me post this role", "write requirements for this position", or wants to define what success looks like in a role - even if they don't explicitly say "job description". Also use when a hiring manager says "I need someone who can do X, Y, Z" and needs that translated into a structured posting.
npx skillsauth add qa-aman/claude-skills job-descriptionInstall 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.
Based on Hire With Your Head by Lou Adler. Traditional JDs list requirements (skills, years of experience, degrees) but don't tell candidates what they'll actually do. Performance-based JDs flip the model: define what "great" looks like in 90 days and 1 year, then work backward to what's required. This filters for candidates who can deliver outcomes, not just match keywords.
Before writing a single word of the posting, answer: "What does this person need to accomplish in the first 90 days to be considered successful?"
Ask [hiring manager]:
Convert answers into 3-5 measurable performance objectives. Format:
- Within 90 days: [specific deliverable or outcome]
- Within 6 months: [milestone or capability reached]
- Within 12 months: [strategic outcome or ownership expanded]
State the mission of the role, not the list of duties. Candidates skim - the opening determines whether they read further.
Bad: "We are looking for a Senior Engineer to join our growing team." Good: "You'll own the data pipeline that powers every dashboard [your company] ships. In the first 90 days, you'll audit what exists, document what's missing, and ship the first version of the new ingestion layer."
# [Role Title] - [Your Company]
## The Role
[2-3 sentence mission. What does this person own? What's the impact?]
## What You'll Do (First 12 Months)
- [90-day outcome]
- [6-month outcome]
- [12-month outcome]
- [Ongoing responsibility 1]
- [Ongoing responsibility 2]
## What We're Looking For
[5-7 bullets. Lead with must-haves, end with nice-to-haves.
Each bullet states a capability, not a credential.
"Built and shipped X" beats "5 years of experience."]
## What We Offer
- Compensation: [$X - $Y base + equity/bonus structure]
- [Benefit 1]
- [Benefit 2]
- [Culture or growth differentiator]
## How to Apply
[Clear next step. Link or instruction. No paragraph of boilerplate.]
Requirements should predict performance. For each requirement, ask: "Can someone without this still achieve the 90-day outcome?" If yes, it's a preference, not a requirement.
Format requirements as:
Avoid:
Use the scope-ownership matrix to anchor level:
| Level | Scope | Ownership | |-------|-------|-----------| | Junior / IC | Defined tasks within a project | Executes with guidance | | Mid | Full features or workstreams | Owns deliverable, escalates blockers | | Senior | Cross-team outcomes | Owns outcome and unblocks others | | Staff / Lead | Org-level capability | Sets direction, multiplies team |
Make sure the performance objectives match the level. A "Senior" JD with junior-level objectives will attract the wrong pool.
1. Leading with company bio Bad: "Founded in 2018, [your company] is a mission-driven SaaS company transforming the way teams collaborate..." Good: Lead with the role's mission and impact. Save the company pitch for an "About Us" section at the bottom.
2. Requirements as a wishlist Bad: "5+ years Python, experience with Kafka, Spark, Airflow, dbt, Snowflake, AWS, GCP, and strong communication skills..." Good: 5-7 must-haves that directly predict the ability to hit the 90-day outcome.
3. Duties list masquerading as outcomes Bad: "Responsible for writing code, attending standups, participating in code review, and collaborating with stakeholders." Good: "Own the auth service - design, build, and maintain it. In 90 days, migrate it off the legacy monolith."
4. Vague compensation Bad: "We offer a competitive compensation package." Good: "$140,000 - $170,000 base depending on experience + 0.1-0.25% equity over 4 years."
5. Burying the interesting work Bad: A wall of text where the most compelling work appears in paragraph 4. Good: First 2-3 sentences are the hook. If they're not compelling, the rest won't be read.
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.