Generate Job Descriptions
A job description writing skill covering inclusive language, legal compliance, SEO optimization, and a ready software engineer JD template.
Why it matters
Create compelling, legally compliant, and SEO-optimized job descriptions that attract top talent and accurately represent your company and roles.
Outcomes
What it gets done
Draft job titles optimized for search engines and candidate queries.
Write clear, concise, and inclusive role overviews and responsibilities.
Incorporate required and preferred qualifications based on best practices.
Ensure legal compliance and adherence to salary transparency laws.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-job-description-generator | bash Overview
Job Description Generator
A skill for writing job descriptions that follow a proven structure, use inclusive and legally compliant language, and are optimized for job-board SEO. It includes a full software engineer template and compensation-transparency guidance for states that require published salary ranges. Use it when drafting or rewriting a job posting that needs to be inclusive, compliant, SEO-aware, and sized to the 300-800 word range job boards favor.
What it does
This skill creates compelling, comprehensive, legally compliant job descriptions following a proven structure: title, department, location, employment type, and experience level; a company overview; a role overview; 8-12 action-oriented responsibility bullets; required and preferred qualifications; a compensation and benefits section; and clear application instructions. It applies inclusive-language rules (replacing gendered pronouns and biased qualifiers like "rockstar", "ninja", or "culture fit", and writing "you will" instead of "the candidate will"), clarity rules (8th-grade reading level, bullet points over dense paragraphs, sentences under 20 words, defined jargon), and legal-compliance guardrails (no age ranges, no appearance, marital-status, or family-planning requirements, a mandatory equal-opportunity statement, and salary-transparency compliance where applicable).
It includes a full software engineer job description example (React, Node.js, and PostgreSQL responsibilities, 80%+ test coverage with Jest and Cypress, CI/CD participation, and cloud/Docker/Kubernetes preferred qualifications), compensation-package guidance (market-rate research via Glassdoor, PayScale, or Radford surveys, salary ranges required in CA, CO, NY, and WA, and total-compensation framing of base plus bonus plus equity plus benefits), SEO and job-board title and keyword optimization, remote and hybrid work-environment templates, a pre-publish quality checklist (searchable title, measurable responsibilities, must-have versus nice-to-have separation, inclusive and bias-free language, compliant compensation info, and a 300-800 word target length), and advanced techniques such as 90-day success-metric framing and candidate-journey optimization with day-in-the-life examples and visible career-progression paths.
When to use - and when NOT to
Use this skill when drafting or rewriting a job description that needs to be inclusive, legally compliant, SEO-optimized for job boards, and structured to a specific length target of 300-800 words. It suits technical and non-technical roles alike, with a ready reference template for software engineering postings and compensation-disclosure guidance for the states that require published salary ranges.
It is not a fit for internal role scoping or compensation-band decisions themselves - it assumes you already know the role's responsibilities, qualifications, and pay range, and focuses on turning that into compliant, well-structured, candidate-facing copy rather than determining what the role or pay should be.
Inputs and outputs
Inputs are the role title, department, location, employment type, seniority level, required and preferred qualifications, and compensation and benefits details, including a salary range where legally required. The output is a complete job description following the proven structure - company overview, role overview, responsibilities, qualifications, compensation and benefits, and application instructions - checked against the quality checklist for length, inclusivity, and compliance before publishing.
Who it's for
Recruiters, hiring managers, and HR or People teams writing job postings who need consistent structure, inclusive and legally compliant language, and SEO-aware titles and keywords across every posting - especially useful for standardizing compensation transparency in jurisdictions that require salary ranges, and for building out an initial technical-role template like the included software engineer example.
Source README
Job Description Generator Expertise
You are an expert in creating compelling, comprehensive, and legally compliant job descriptions that effectively attract qualified candidates while accurately representing role expectations and company culture. You understand modern recruitment best practices, inclusive language principles, SEO optimization for job boards, and employment law considerations.
Core Job Description Structure
Every job description should follow this proven structure:
### Job Title
**Department:** [Department Name]
**Location:** [City, State/Remote/Hybrid]
**Employment Type:** [Full-time/Part-time/Contract]
**Experience Level:** [Entry/Mid/Senior/Executive]
### About [Company Name]
[2-3 sentences about company mission, values, and culture]
### Role Overview
[2-3 sentences summarizing the position's purpose and impact]
### Key Responsibilities
- [8-12 specific, action-oriented bullet points]
- Use strong action verbs (develop, lead, implement, analyze)
- Include both day-to-day tasks and strategic objectives
### Required Qualifications
- [Education requirements]
- [Years of experience]
- [Technical skills]
- [Certifications if applicable]
### Preferred Qualifications
- [Nice-to-have skills]
- [Additional experience]
- [Bonus qualifications]
### What We Offer
- [Compensation range if permitted by law]
- [Benefits]
- [Professional development opportunities]
- [Work environment highlights]
### How to Apply
[Clear application instructions]
Writing Principles
Use Inclusive Language
- Avoid gendered pronouns and terms ("he/she" → "they", "guys" → "team")
- Replace biased qualifiers: "rockstar", "ninja", "culture fit"
- Focus on skills rather than personality traits
- Use "you will" instead of "the candidate will"
Optimize for Clarity
- Write at 8th-grade reading level
- Use bullet points instead of dense paragraphs
- Keep sentences under 20 words
- Define technical jargon and acronyms
Technical Role Examples
Software Engineer Job Description Template
### Key Responsibilities
- Design, develop, and maintain scalable web applications using React, Node.js, and PostgreSQL
- Collaborate with product managers and designers to translate requirements into technical solutions
- Write clean, testable code with 80%+ test coverage using Jest and Cypress
- Participate in code reviews and contribute to architectural decisions
- Troubleshoot production issues and implement monitoring solutions
- Mentor junior developers and contribute to team knowledge sharing
### Required Qualifications
- Bachelor's degree in Computer Science or equivalent experience
- 3+ years of experience with JavaScript/TypeScript and modern frameworks
- Proficiency with version control (Git) and CI/CD pipelines
- Experience with RESTful APIs and database design
- Strong problem-solving skills and attention to detail
### Preferred Qualifications
- Experience with cloud platforms (AWS, GCP, or Azure)
- Knowledge of containerization (Docker, Kubernetes)
- Familiarity with agile development methodologies
- Contributions to open-source projects
Compensation and Benefits Strategy
Salary Range Guidelines
- Research market rates using Glassdoor, PayScale, or Radford surveys
- Include ranges where legally required (CA, CO, NY, WA)
- Consider total compensation: base + bonus + equity + benefits
- Be transparent about commission structure for sales roles
### Compensation Package
**Base Salary:** $90,000 - $120,000 (based on experience)
**Annual Bonus:** Up to 15% of base salary
**Equity:** Stock options with 4-year vesting
**Benefits:**
- Health, dental, and vision insurance (100% premium covered)
- 401(k) with 4% company match
- $2,000 annual learning and development budget
- Flexible PTO policy
- Remote work stipend: $500 quarterly
SEO and Job Board Optimization
Title Optimization
- Use standard job titles that candidates search for
- Include seniority level: "Senior Product Manager" vs "Product Manager"
- Avoid internal jargon: "Customer Success Manager" not "Client Happiness Hero"
- Consider location in title for local searches
Keyword Integration
- Research relevant skills and tools in your industry
- Include both technical and soft skills naturally in text
- Use variations: "JavaScript", "JS", "ECMAScript"
- Add industry-specific certifications and methodologies
Remote and Hybrid Work Considerations
### Work Environment
**Remote-First Culture:** This position can be performed fully remotely with occasional team gatherings
**Equipment Provided:** MacBook Pro, monitor, ergonomic chair, and desk setup allowance
**Collaboration Tools:** Slack, Zoom, Miro, GitHub, and Notion
**Time Zone Requirements:** Core collaboration hours 10 AM - 2 PM EST
**Travel:** Quarterly team meetups (travel expenses covered)
Quality Checklist
Before publishing, verify:
- Job title is searchable and industry-standard
- Responsibilities are specific and measurable
- Requirements distinguish between "must-have" and "nice-to-have"
- Language is inclusive and bias-free
- Compensation information complies with local laws
- Contact information and application process are clear
- Company branding and culture are authentically represented
- Technical requirements match actual role needs
- Length is 300-800 words (optimal for job board algorithms)
Advanced Techniques
Competency-Based Descriptions
Frame requirements around demonstrated abilities:
### Success Metrics
In your first 90 days, you will:
- Complete onboarding and contribute to 2 product releases
- Establish relationships with key stakeholders across 4 departments
- Identify and implement 1 process improvement in your area
Candidate Journey Optimization
- Include day-in-the-life examples
- Showcase career progression opportunities
- Address common candidate concerns proactively
- Provide realistic timeline expectations for hiring process
Always tailor each job description to the specific role, company culture, and target candidate profile while maintaining these structural and strategic principles.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.