Framework for writing job descriptions that attract the right candidates by defining business impact.
Works with
Start with 12-month success: define what changes in the business after the hire, not a list of daily tasks
Identify the spike: determine one or two areas where the candidate must excel, rather than seeking a generalist
Replace proxies with outcomes: frame requirements around specific capabilities and progress, not years of experience or tool lists
Use polarizing language intention
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versionwriting-job-descriptionsExecute the skills CLI command in your project's root directory to begin installation:
Fetches writing-job-descriptions from refoundai/lenny-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate writing-job-descriptions. Access via /writing-job-descriptions in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
616
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
616
stars
Help the user write effective job descriptions using frameworks and insights from 6 product leaders.
When the user asks for help with job descriptions:
Jonathan Lowenhar: "Start with, it's 12 months later, you hired the person, 12 months have gone by, you're clinking champagne because of how great it's been. What's changed about the business?" Define success by business impact after one year, not a list of responsibilities.
Bob Moesta: "Job descriptions are made up. They're literally just made up - a list of stuff the manager wants plus stuff they don't want to do." Focus on the 'progress' the role enables rather than arbitrary feature requirements.
Lauren Ipsen: "Trying to determine where this person should major and minor, where they should spike. Is this someone that's going to lean into design efforts or operate like a very senior PM?" Define specific competencies required rather than seeking a generalist who does everything.
Bob Moesta: "Don't tell me I need Excel, PowerPoint, and Word skills. Tell me what I'm going to do with those. Tell me you're going to need to build PowerPoints for executive alignment." Replace 'X years of experience' with specific capabilities that time is supposed to represent.
Jason Shah: "Taking a product mindset where I meet people and don't know exactly what role they're going to fill. A product mindset on hiring and iterating on it based on the candidates you're meeting." Treat job descriptions as iterative documents that evolve with market reality.
Anton Osika: "Long hours, high pace, candidates must thrive under high urgency. Those seeking comfortable work need not apply." High-signal, polarizing language filters for candidates who thrive in specific environments.
Peter Deng: "I asked her to write up a job description of what this thing is. There's something magical here. The role was model designer." Ask high-performing individuals to write their own ideal job description to identify new functional needs.
For all 9 insights from 6 guests, see references/guest-insights.md
Make data-driven prioritization decisions faster
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Prerequisites
Time Estimate
30-60 minutes to see productivity improvements
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid when
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
davila7/claude-code-templates
mattpocock/skills
parcadei/continuous-claude-v3
cursor/plugins
ailabs-393/ai-labs-claude-skills
pproenca/dot-skills
writing-job-descriptions reduced setup friction for our internal harness; good balance of opinion and flexibility.
writing-job-descriptions is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
writing-job-descriptions has been reliable in day-to-day use. Documentation quality is above average for community skills.
writing-job-descriptions reduced setup friction for our internal harness; good balance of opinion and flexibility.
Solid pick for teams standardizing on skills: writing-job-descriptions is focused, and the summary matches what you get after install.
I recommend writing-job-descriptions for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
writing-job-descriptions fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
I recommend writing-job-descriptions for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
Useful defaults in writing-job-descriptions — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
Useful defaults in writing-job-descriptions — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
showing 1-10 of 41