New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Job Description

by shawnpang in shawnpang/startup-founder-skills

When the user needs to write, review, or improve a job posting for a startup role.

MITAuto-check passedBusiness, Finance & HR

Install Job Description

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill job-description -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills job-description --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/job-description .claude/skills/job-description && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
job-description
GitHub stars
343
Token cost
~1.5k tokens
SKILL.md length
682 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to write, review, or improve a job posting for a startup role.

  • Works in 7 steps: Clarify the role — Ask the user what… → Draft the hook — Write a 2-3 sentence… → Structure the body — Organize into five… → …
  • Improve a job posting for a startup role
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Job Description is an agent skill from shawnpang/startup-founder-skills. When the user needs to write, review, or improve a job posting for a startup role.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Recruiting and HR. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Improve a job posting for a startup role
  • Tasks that involve Recruiting and HR

Example prompts

  • “/job-description”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Clarify the role — Ask the user what problem this hire solves. A JD should start from business need, not a generic title. Confirm level…
  2. Draft the hook — Write a 2-3 sentence opening that connects the company mission to why this role matters right now. Avoid generic openers…
  3. Structure the body — Organize into five sections: Mission & Impact, What You'll Do (6-8 bullets), What You Bring (5-7 bullets split into…
  4. Apply anti-pattern checks — Scan the draft for corporate jargon, unrealistic requirement stacking, gendered language, and exclusionary…
  5. Add startup-specific framing — Emphasize ownership, speed of impact, equity upside, learning velocity, and access to leadership. These are…
  6. Review comp and inclusivity — Ensure compensation transparency (range or "we'll share in first conversation"). Confirm language passes…
  7. Final polish — Tighten to a scannable length (400-700 words). Ensure the tone matches the company voice from startup-context.

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Job Description loads about 1.5k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 682 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 682 words, ~1,530 tokens.

Download SKILL.mdSave it as .claude/skills/job-description/SKILL.md (or your agent's skills folder).
name
job-description
description
When the user needs to write, review, or improve a job posting for a startup role.
related
interview-kit, sourcing-outreach, employer-brand
reads
startup-context

Job Description

When to Use

Activate when the user asks to create a new job posting, rewrite an existing one, or get feedback on a draft JD. Also activate when the user is preparing to hire for a new role and needs to define it clearly before sourcing candidates.

Context Required

  • From startup-context: Company name, mission statement, stage/funding, tech stack (for eng roles), team size, remote/hybrid/onsite policy, benefits, and equity structure.
  • From user: Role title, reporting structure, seniority level, key responsibilities, must-have vs. nice-to-have qualifications, compensation range (or willingness to include one), and hiring timeline.

Workflow

  1. Clarify the role — Ask the user what problem this hire solves. A JD should start from business need, not a generic title. Confirm level, scope, and team placement.
  2. Draft the hook — Write a 2-3 sentence opening that connects the company mission to why this role matters right now. Avoid generic openers like "We are looking for a rockstar..."
  3. Structure the body — Organize into five sections: Mission & Impact, What You'll Do (6-8 bullets), What You Bring (5-7 bullets split into must-have and nice-to-have), What We Offer, and How to Apply.
  4. Apply anti-pattern checks — Scan the draft for corporate jargon, unrealistic requirement stacking, gendered language, and exclusionary phrasing. Flag and fix.
  5. Add startup-specific framing — Emphasize ownership, speed of impact, equity upside, learning velocity, and access to leadership. These are startup advantages over big-co offers.
  6. Review comp and inclusivity — Ensure compensation transparency (range or "we'll share in first conversation"). Confirm language passes inclusive-language guidelines.
  7. Final polish — Tighten to a scannable length (400-700 words). Ensure the tone matches the company voice from startup-context.

Output Format

A complete, ready-to-post job description in markdown with the following sections:

  • Title and location/remote line
  • Opening hook (2-3 sentences)
  • About Us (3-4 sentences)
  • What You'll Do (bulleted list)
  • What You Bring (must-haves and nice-to-haves, clearly separated)
  • What We Offer (bulleted list)
  • How to Apply (1-2 sentences with clear next step)

Frameworks & Best Practices

The HERO Structure
  • Hook: Why this role matters to the mission right now
  • Expectations: What the person will actually do day-to-day
  • Requirements: What they genuinely need to succeed (not a wish list)
  • Offer: What the company gives back (comp, equity, growth, culture)
Anti-Patterns to Avoid
  • Requirement inflation: Listing 15+ requirements signals you don't know what you need. Keep must-haves to 4-5.
  • Corporate jargon: "Synergy," "leverage," "fast-paced environment" are empty. Use concrete language.
  • Gendered language: Avoid "ninja," "rockstar," "aggressive." Use tools like the Gender Decoder or Textio guidelines as a reference.
  • Years-of-experience gates: "7+ years of React" excludes strong candidates. Prefer demonstrated capability over tenure.
  • Hidden role: If the job is actually three jobs, split it or be honest about the breadth.
Show full SKILL.md (234 more words)Show less
Inclusive Language Guidelines
  • Use "you" instead of "the ideal candidate" to feel inviting rather than evaluative.
  • Replace "requirements" with "what you bring" to reduce self-screening by underrepresented candidates.
  • Include an explicit encouragement to apply even if not a 100% match (research shows this matters for women and minority applicants).
  • State accommodation availability for the interview process.
Compensation Transparency
  • Include a salary range. Listings with ranges get significantly more applicants.
  • If equity is offered, state the range in percentage or share count and mention the vesting schedule.
  • Name benefits explicitly rather than saying "competitive benefits package."
Startup-Specific Framing
  • Impact: "You'll be one of the first 10 engineers shaping the product architecture."
  • Ownership: "You'll own the entire lifecycle of features, from design through production monitoring."
  • Equity: "We offer meaningful equity because early employees take real risk and deserve real upside."
  • Growth: "As we scale from 10 to 50, you'll grow into a leadership role if you want it."
  • interview-kit — After posting the JD, design the interview loop and scorecards for this role.
  • sourcing-outreach — Use the JD as the basis for personalized outreach messages to passive candidates.
  • employer-brand — Ensure the JD tone and content align with your careers page and employer brand narrative.

Examples

Prompt: "We need to hire our first product designer. We're a 12-person B2B SaaS startup, Series A, remote-first."

Good output snippet:

# Product Designer — Remote (US/Canada time zones)

Join Acme as our founding designer and shape the product experience
from the ground up. You won't be handed a pixel-perfect spec — you'll
partner directly with engineering and customers to figure out what to
build and how it should feel.

## What You'll Do
- Own the end-to-end design process for our core B2B platform
- Run discovery calls with customers weekly to ground designs in real workflows
- Build and maintain our design system as the foundation for a future team
- Collaborate async-first with engineering using Figma and Loom
...

Prompt: "Review this JD for red flags."

Good output snippet:

Issues found:
1. "Must have 10+ years in Python" — This filters out strong mid-career
   candidates. Consider "deep fluency in Python" instead.
2. "Fast-paced environment" — This is vague. Replace with something
   concrete: "We ship weekly and iterate based on customer feedback."
3. No salary range listed — Adding a range will increase your applicant
   pool significantly.

© shawnpang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/job-description of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Job Description next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Job Description compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Job Description this skillshawnpang/startup-founder-skills343—~1.5kAutomated safety check: PassMIT
Get Jobagentenatalie/get-job.skill632—~1.7kAutomated safety check: PassCC-BY-NC-ND-4.0
Resume Reviewerweeelin98/ResumeDom173—~2.4kAutomated safety check: PassNone
Build Resume Portfolio Sitetao943/build-resume-portfolio-site195—~5.8kAutomated safety check: PassNone
Cyber Resume Reviewermubix/cyber-resume-reviewer-skill184—~2.9kAutomated safety check: PassMIT
Repo To Resume TailorSsabby1/repo-to-resume-tailor127—~1.8kAutomated safety check: PassMIT

Similar skills

  • Get Job

    agentenatalie/get-job.skill

    实习.skill / get-job.skill：从岗位调研、简历改写到分轮次面试准备的全流程求职 skill。适合找工作、投实习、校招、秋招、春招、暑期实习、社招、跳槽、转行、跨专业求职、留学生求职，以及产品经理、运营、市场、咨询、AI 产品、AI Coding、数据分析、技术岗等目标岗位准备。

    632 GitHub stars~1.7k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

  • Resume Reviewer

    weeelin98/ResumeDom

    Build, assess, review, and tailor evidence-backed US-market technology resumes for computer-science interns and new graduates.

    173 GitHub stars~2.4k tokensUpdated 15 days ago
    Business, Finance & HRAuto-check passed

  • Build Resume Portfolio Site

    tao943/build-resume-portfolio-site

    A skill your agent uses when turning resume materials and an optional job description into verified, approved content and a runnable React + Vite resume or portfolio site, or when redesigning an…

    195 GitHub stars~5.8k tokensUpdated 10 days ago
    Business, Finance & HRAuto-check passed

  • Cyber Resume Reviewer

    mubix/cyber-resume-reviewer-skill

    Review, tailor, score, or rewrite IT and cybersecurity resumes.

    184 GitHub stars~2.9k tokensUpdated 20 days ago
    Business, Finance & HRAuto-check passed

  • Repo To Resume Tailor

    Ssabby1/repo-to-resume-tailor

    Analyze a full code repository and generate one resume-ready project description grounded in repository evidence.

    127 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed

  • GitHub Project Contributor Finder API Skill

    browser-act/skills

    This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates.

    6.1k GitHub starsUsed in 1 repo~1.9k tokens
    Business, Finance & HRAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo

  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed

  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed

  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed

  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed

  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed

  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Job Description

What does Job Description do?

When the user needs to write, review, or improve a job posting for a startup role. Job Description is an agent skill from shawnpang/startup-founder-skills. When the user needs to write, review, or improve a job posting for a startup role.

When should I use Job Description?

Job Description fits situations like: improve a job posting for a startup role; tasks that involve Recruiting and HR.

How do I install Job Description in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill job-description -a claude-code`. Or copy the skill folder (skills/job-description in shawnpang/startup-founder-skills) into .claude/skills/job-description in your project. Claude Code loads it when a task matches its description.

How do I install Job Description in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill job-description -a codex`. Or copy the skill folder (skills/job-description in shawnpang/startup-founder-skills) into .agents/skills/job-description in your project. Codex loads it when a task matches its description.

Can I use Job Description in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shawnpang/startup-founder-skills --skill job-description -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/job-description, .gemini/skills/job-description, .github/skills/job-description and .opencode/skills/job-description in your project.

What does Job Description need to run?

SKILL.md names no scripts, command-line tools or credentials: Job Description is instructions for the agent only.

Does Job Description access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Job Description safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Job Description use?

Job Description is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Job Description use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Job Description?

Skills that share tags, products or a category with Job Description: Get Job (agentenatalie/get-job.skill, 632 stars), Resume Reviewer (weeelin98/ResumeDom, 173 stars), Build Resume Portfolio Site (tao943/build-resume-portfolio-site, 195 stars) and Cyber Resume Reviewer (mubix/cyber-resume-reviewer-skill, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Job Description?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.