writing-job-descriptions

Generate outcome-based job descriptions and role scorecards with competency spikes.

51|8|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/liqiongyu/lenny_skills_plus --skill writing-job-descriptions-liqiongyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-job-descriptions
Source: https://github.com/liqiongyu/lenny_skills_plus/tree/main/skills/writing-job-descriptions
Command: npx skills add https://github.com/liqiongyu/lenny_skills_plus --skill writing-job-descriptions-liqiongyu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation of outcome-based job descriptions and role scorecards, ensuring that hiring efforts attract the right candidates and effectively filter out unsuitable ones.

Core Features & Use Cases

  • Outcome-Based JD Creation: Generates job descriptions focused on measurable success at 12 months.
  • Role Scorecard Development: Creates scorecards defining key competencies and success metrics.
  • High-Signal Filtering: Includes candid sections on team realities and candidate fit to improve self-selection.
  • Use Case: When hiring for a new role, use this Skill to go from a basic job title to a complete Job Description Pack, including a scorecard, competency spikes, and a public-facing JD, ensuring clarity and attracting qualified applicants.

Quick Start

Write a job description for a Senior PM for <company>, starting with success at 12 months, defining major/minor spikes, then outputting the full Job Description Pack.

Frequently Asked Questions about writing-job-descriptions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an outcome-based job description for hiring?

An outcome-based job description defines success at 12 months, identifies competency spikes, and includes candid filtering sections to attract qualified candidates and filter out unsuitable ones.

What is the best way to create a role scorecard for talent acquisition?

The best way to create a role scorecard is to define key competencies and success metrics during the intake process, mapping major and minor spikes to ensure high-signal filtering of candidates.

How do I generate a complete Job Description Pack for a new role?

You can generate a complete Job Description Pack by running the intake, scorecard definition, spike mapping, responsibility translation, and JD drafting process to output both internal metrics and a public-facing job description.

Can I include candid team realities in my job descriptions to improve candidate self-selection?

Yes, you can include candid sections on team realities and candidate fit in your job descriptions to provide high-signal context, which improves self-selection and filters out unsuitable applicants.

How does defining competency spikes improve the recruiting process?

Defining competency spikes improves recruiting by highlighting the specific major and minor skills required for success at 12 months, ensuring the job description targets qualified candidates with exact role clarity.

What is the process for iterating on a job description after the initial draft?

The process for iterating on a job description involves utilizing provided templates and checklists for quality assurance during the drafting phase, followed by structured iteration planning to refine the high-signal filtering sections.