Job Description Writer
SkillDev toolsWrite structured job descriptions with clear requirements, responsibilities, and employer value proposition. Follows SHRM BASK competency framework. Adapts tone to employer brand and industry context. Use when creating new positions or updating existing JDs. Do not use for internal performance criteria or career ladder definitions.
Use Job Description Writer in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add Job Description Writer and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the Job Description Writer skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
What this skill tells your AI
The instructions your AI receives, as published by hoavdc/codexkit in skills/codexkit-job-description-writer/SKILL.md and read by Ahel’s review.
Purpose
Create compelling, accurate job descriptions that attract the right candidates by clearly communicating the role, requirements, and employer value proposition.
When to use
- opening a new position and need a JD from scratch
- updating outdated job descriptions
- standardizing JD format across the organization
- creating localized JDs for different markets
When not to use
- defining career levels or promotion criteria
- writing performance review criteria
- creating training curricula
Inputs
- job title and level (junior / mid / senior / lead / director)
- department and reporting line
- key responsibilities (rough list is fine)
- must-have vs nice-to-have qualifications
- employment type (full-time, part-time, contract, remote)
- salary range or band (optional but recommended)
- company culture keywords or employer brand tone
- industry and location
Procedure
- Write the role summary (2–3 sentences):
- What the role does, who it reports to, and why it matters
- Focus on impact, not just activities
- Define key responsibilities (5–8 bullet points):
- Start each with an action verb
- Order by importance, not alphabetically
- Be specific: "Design and launch 3 marketing campaigns per quarter" not "manage marketing"
- List qualifications in two tiers:
- Must-have (hard requirements) — be honest, don't inflate
- Nice-to-have (preferred but not required) — keeps the pool open
- Include SHRM competency alignment where applicable:
- Technical competency: domain knowledge required
- Behavioral competency: communication, leadership, analytical thinking
- Write the EVP section (Employer Value Proposition):
- What the company offers beyond salary
- Growth opportunities, culture, benefits, mission
- Add practical details:
- Location (or remote policy), travel requirements
- Salary range (if applicable — improves candidate quality)
- Application instructions and timeline
- Inclusive language check:
- Remove gendered language
- Avoid unnecessary degree requirements
- Flag biased phrases (e.g., "rockstar", "ninja", "young and dynamic")
Output
- complete job description with all sections
- inclusive language audit notes
- suggested job boards or channels for this role type
- interview focus areas based on the JD
Definition of done
- role summary clearly explains impact, not just tasks
- responsibilities use action verbs and are specific
- qualifications are split into must-have and nice-to-have
- inclusive language check is complete
- EVP section is present
Examples
- "Write a JD for a Senior Product Manager at a B2B SaaS company in Ho Chi Minh City."
- "Update this outdated marketing manager JD to be more inclusive and specific."
- "Create a JD for a remote Data Analyst role — we're a startup, keep it authentic."
Quality Criteria
- All placeholder sections are filled with domain-specific content
- Structure follows the relevant industry standard or framework
- Language matches target audience (technical / executive / legal)
- Output is ready for review — not a rough draft requiring major rework
Verification (4C)
| Check | Question |
|---|---|
| Correctness | Does the draft structure follow the stated framework or industry standard? |
| Completeness | Are all required sections present with substantive (not placeholder) content? |
| Context-fit | Does tone, detail level, and terminology match the intended audience? |
| Consequence | If sent to the intended recipient without further editing, what would fail? |
Edge Cases
- No existing template for this type — Use the closest available template and document all customizations made.
- Stakeholder requirements conflict — Flag conflicts explicitly in the draft. Do not silently choose one requirement over another.
- Output required in multiple formats — Produce the canonical format first, then derive others. Note any formatting limitations.
Changelog
- v1.0.0 — Initial release
Signals
- GitHub stars
- 25
- Forks
- 13
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
codexkit-job-description-writer- Source
- github.com/hoavdc/codexkit