Directory/Skills Directory/Agency Recruiting Pack/Job Description Cleanup

Job Description Cleanup skill

Rewrites long internal job descriptions into posts of 250 to 400 words that lead with outcomes, keep only true requirements, and drop exclusionary wording. It flags a missing pay range where posting laws apply, never invents perks, and lists every change you may need to clear with the client.

  • Job descriptionscategory
  • No scriptsinstructions only, sends nothing
  • Any AI appupload, or copy and paste

Free, no signup

Upload the file to Claude, ChatGPT Business or Gemini Enterprise. On ChatGPT Plus, the free Gemini app or Grok, copy and paste it instead.

Download the fileCopy with your details

Part of the Agency Recruiting Pack · View on GitHub (opens in a new tab)

What the Job Description Cleanup skill does

Ask it things like:

  • “Clean up this client JD for Indeed and LinkedIn”
  • “Check this post for biased or risky wording”
  • “Turn this req into a job ad, the client is confidential”
Best for
Recruiters turning a client's internal job description into a job post
Author
Work Insiders
Needs
Nothing beyond your AI assistant
License
MIT
Runs in
Claude, Gemini Enterprise, Gemini CLI, Gemini app (as a Gem), ChatGPT, Codex, Grok

How to use Job Description Cleanup in Claude, ChatGPT, Gemini or Grok

Claude upload

  1. In Claude, open Settings (or Customize), then Skills, then Upload.
  2. Upload job-description-cleanup.zip as it is. Don't unzip it.
  3. Check it is switched on.
  4. Test it: start a new chat and type Use job-description-cleanup, then paste what you have.

Team and Enterprise owners may need to allow skills first.

ChatGPT Business, Enterprise or Edu upload

  1. In the sidebar, click Plugins, then the Skills tab.
  2. Click Create, then Upload from your computer, and pick job-description-cleanup.zip.
  3. ChatGPT scans it, then uses it on its own or when you @ mention it.

An admin has to switch skills on for the workspace first.

ChatGPT Plus, Pro or Free paste

  1. Open the copy tool on the pack page, pick ChatGPT and click Copy. It adds your agency profile if you filled it in.
  2. In ChatGPT, click Projects, then New project, and name it after the skill.
  3. Open the project's Instructions and paste.
  4. Start a chat inside that project and paste what you have: your notes, a job order, a pipeline list or a client's email.

These plans have no skill upload. A project keeps the instructions for every chat inside it.

Gemini Enterprise upload

  1. In the Gemini Enterprise web app, click Skills in the menu.
  2. Click +, then Upload skill, pick job-description-cleanup.zip and click Import.
  3. Call it with / in a chat, or let Gemini pick it up on its own.

Standard, Plus and Pay-as-you-go editions can upload. An admin has to switch skills on first.

Gemini app paste

  1. Open the copy tool on the pack page, pick Gemini Gem and click Copy. It adds your agency profile if you filled it in.
  2. In the Gemini app, make a new Gem (a custom assistant) and paste it into the Gem's instructions.
  3. Chat with that Gem whenever you need the skill.

Grok paste

  1. Open the copy tool on the pack page, pick Grok and click Copy. It adds your agency profile if you filled it in.
  2. Paste it into a chat with your Grok Bot. The first line asks it to save the skill with Skill Creator.
  3. Review the draft and save it, then switch it on under Settings, Plugins, Yours. Call it with / in a chat.

Developers folder

  1. Gemini CLI or Antigravity: unzip into .gemini/skills/ in your project, or ~/.gemini/skills/ for every project.
  2. Claude Code: ~/.claude/skills/, or install a whole pack as a plugin from our GitHub repo. Grok Build: .grok/skills/.

Steps follow OpenAI's skills guide and Google's Gemini Enterprise guide. Menu names change, so check there if a label looks different.

The full instruction file (SKILL.md)

Nothing hidden: this is the whole file. Want it with your agency's details filled in, or formatted for ChatGPT, a Gemini Gem or Grok? Use the copy tool on the Agency Recruiting Pack page.

---
name: job-description-cleanup
description: Rewrites a client's job description into a job post candidates will read and apply to, with honest requirements, pay transparency where the law requires it, and inclusive wording. Use when a recruiter pastes a job description and asks to "clean up", "rewrite", "make this post better", "write a job ad", "turn this req into a posting", or check a post for biased or risky language.
license: MIT
metadata:
  author: Work Insiders
  version: "1.0"
  pack: agency-recruiting-pack
---

# Job description cleanup

Clients hand agencies long, internal job descriptions full of duties nobody reads. You turn them into a post that sells the role and screens honestly.

If `references/agency-profile.md` exists, read it for how the agency posts (confidential client or named, where it posts, EEO line, apply instructions).

## Inputs

- The client job description or job order.
- Pay range and work location (city, hybrid days, or remote). If missing, ask; see the pay rules below.
- Whether the client name can appear.

## Output: the post

```
[Job title]: plain, searchable, no internal codes ("Senior Mechanical Engineer", not "ME III - Grade 7")
[City, State] | [On site / Hybrid n days / Remote (US)] | [Direct hire / Contract n months / Contract to hire]
Pay: [$min to $max per year or per hour] [+ bonus or other pay if known]

What you'll do
- 4 to 6 bullets, outcomes first ("Design fixtures for a new EV battery line"), not duty lists.

What you need
- 3 to 5 true requirements.

Nice to have
- 2 to 4 items.

Why this role
- 3 bullets: the real reasons someone would move (team, project, schedule, growth, benefits).

How to apply
- [Agency apply instructions]

[EEO statement from agency profile]
```

Target 250 to 400 words.

## What to fix

- **Requirement inflation.** Move anything the client called "required" but said was trainable or a preference into Nice to have. Flag every requirement you moved.
- **Years of experience.** Replace "10+ years" with the skill it stands for where you can ("has led a full design cycle from concept to production"). Keep a years figure only if the client insists.
- **Degree requirements.** If the work does not need a specific degree, suggest "or equivalent experience" and flag it.
- **Exclusionary wording.** Replace words like "rockstar", "ninja", "young", "energetic", "digital native", "native English speaker", "recent graduate" (unless it is a graduate program), and physical requirements that the job does not truly need. Keep real physical requirements but state them as the task ("lifts 40 lb parts several times a shift").
- **Internal jargon.** Spell out acronyms on first use unless candidates in the field all know them.

## Pay transparency

A growing number of US states and cities require a pay range in the posting itself (for example California, Colorado, New York and Washington), each with its own size thresholds and rules. Laws change, so:
- If the role is in, or open to remote workers in, a place with a posting law and there is no range, stop and tell the recruiter the post likely needs one before it goes up.
- Never invent a range.
- Say "check current rules for [state]" rather than giving legal advice.

## Rules

- Do not add duties, perks or benefits the client did not mention.
- Keep the client's name out if the agency profile or the recruiter says the search is confidential. Describe the company instead.
- After the post, list every change that a client might push back on (moved requirements, removed wording, missing pay range) so the recruiter can clear them with the client.
The agency profile it reads (fill this in so it uses your real details)
# Agency profile

Fill this in once. Every skill in the pack reads it, so every output comes out in your agency's voice with your real terms. Delete any line you do not want the AI to use. Leave a line blank rather than guessing.

## Who we are
- Agency name:
- Recruiter name and title (for sign-offs):
- Phone:
- Mailing address (needed for US commercial email):
- Years in business:
- Specialties (roles we fill):
- Markets (cities, regions or "US remote"):
- Industries we know best:

## Terms
- Direct hire fee basis (e.g. % of first-year base):
- Guarantee period and type (free replacement / pro-rata refund / credit; conditions, e.g. fee paid within terms):
- Contract markup or bill rate approach:
- Exclusive or retained options:
- Payment terms (e.g. net 30 from start date):
- Introduction period (how long a candidate we introduce stays ours):
- Contract-to-hire conversion fee:
- Concessions we allow, and their limits:

## Proof points we can share
- Placements, time to fill, or retention figures we are happy to quote:
- Client names we may mention (only with permission):

## How we work
- ATS:
- Do we text candidates? (yes/no):
- Name the client in first candidate messages? (yes/no):
- Blind profiles: always / new clients only / never:
- Include pay expectation in submittals? (yes/no):
- Job post apply instructions:
- EEO statement:

## Cold email
- Sequencer we use (e.g. Instantly, Smartlead, EmailBison, lemlist, Apollo):
- Sending domains (lookalikes only, never our main domain):
- Mailboxes and the sender names on them:
- Countries we email (sets which email and data laws apply):
- Opt-out line we use (e.g. "Reply 'no' and I won't email again."):
- Booking link (sent only after someone replies yes):
- Where our current clients, opt outs and do-not-contact list are kept:

## Words we never use
-

Tools that pair with this skill

Full directory

Connect the MCP server too, so your assistant can act inside the tool while it follows this skill: Indeed, ZipRecruiter.

Questions

Is the Job Description Cleanup skill free?

Yes. It is part of the free Work Insiders Agency Recruiting Pack, MIT licensed, so you can edit and share it.

Does Job Description Cleanup work in Gemini?

Yes. Upload it in Gemini Enterprise or drop the folder into Gemini CLI's skills folder. In the regular Gemini app, paste its instructions into a Gem.

Can I trust it with my data?

It has no scripts and sends nothing anywhere. Whatever you paste goes only to your AI assistant, under that assistant's own data terms, so remove candidate details you do not need first. It can still steer how the assistant answers, so read it before you use it.

The rest of the pack, and similar skills

Full Skills Directory

Written by Work Insiders for agency recruiters. Fill in the agency profile before you use it so it never invents fees or proof points. How we make money.