agentleFS
SkillMedevSkillMedev/people-ops-recruiting/skills/jd-bias-scrubber/SKILL.md

jd-bias-scrubber

Skill0 starsChanged 41 days agoMITView on GitHub

Audits a job description for exclusionary, gendered, age-coded, ableist, and pedigree-gatekeeping language and returns a findings table with neutral rewrites and severity. Use when drafting, reviewing, or auditing a job posting or JD before it is published, when asked to check a role description for biased or non-inclusive wording, or before a requisition goes to a job board.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every flag names the specific phrase and a concrete reason it excludes or carries risk - no generic "this could be biased."

    line 25
  2. Distinctive:

    Every flag pairs with a usable neutral rewrite, not just a deletion.

    line 26
  3. Distinctive:

    Do NOT assert a phrase is definitively illegal - you are an advisory pass, not an approver, and a human owns final wording and legal review.

    line 33
  4. Distinctive:

    Do NOT silently rewrite the JD.

    line 34
  5. Distinctive:

    Do NOT strip or soften genuine, job-relevant requirements to chase neutrality.

    line 35
  6. Distinctive:

    Do NOT use a candidate's name, an applicant's traits, or any protected characteristic in your analysis - you assess the text, not people.

    line 36
  7. Distinctive:

    Do NOT use this to screen resumes, evaluate applicants, or do general copyediting - this audits the job posting's language only.

    line 37

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

JD Bias Scrubber

Surface words and requirements in a job description that deter qualified candidates without adding predictive value, and propose neutral rewrites the hiring manager can accept or reject. You flag; you never silently rewrite intent. Remember the asymmetry the audit exists to correct: a widely cited internal HP study found women tend to apply only when they meet ~100% of listed requirements while men apply at ~60% - every unnecessary requirement shrinks the pool unevenly.

Workflow

  1. Scan for gender-coded language. Flag masculine-coded terms ("dominant," "aggressive," "rockstar," "crush it," "competitive," "ninja") and feminine-coded terms that skew the pool; propose role-relevant neutral phrasing ("sets a high bar," "delivers results"). Flag pronoun assumptions and replace with "you" or the role title.
  2. Catch age and experience coding. Flag "digital native," "recent grad," "high energy," "young team," and maximums like "no more than 5 years." Question any years-of-experience minimum above what the work requires - minimums above 5 years rarely map to competency for non-executive roles; convert them to the actual competency or a soft range, since high minimums screen out career changers and returners.
  3. Surface ableist and physical-demand language. Flag "able-bodied," blanket "must stand for hours," and "fast-paced high-pressure" used as a personality filter. Flag metaphors ("see," "walk," "strong") when not literal job functions. Where a physical demand is genuine, state it precisely and pair it with an accommodation note instead of a blanket exclusion.
  4. Question credential and pedigree gatekeeping. Flag degree requirements, "top university," "Big Tech experience," and citizenship/native-speaker phrasing that exceed legal or job need. Suggest the demonstrable skill instead. Flag "native English speaker" as possible national-origin discrimination; prefer "fluent professional English." Flag a required-qualifications list longer than 5-7 items: recommend demoting the rest to "nice to have."
  5. Output the findings table. Return one row per flagged phrase with columns: flagged phrase, why it may exclude, suggested neutral alternative, severity (legal-risk / pool-shrinking / tone). Preserve substantive requirements; challenge only those with no job-relevant basis.

Deliverable

Produce the findings table - one row per flagged phrase with the phrase, why it may exclude, a usable neutral rewrite, and severity - topped by a two-line summary: total flags by severity, and whether the JD is publishable once legal-risk rewrites are accepted or explicitly waived by counsel.

Quality bar

  • Every flag names the specific phrase and a concrete reason it excludes or carries risk - no generic "this could be biased."
  • Every flag pairs with a usable neutral rewrite, not just a deletion.
  • Severity is assigned to each row so the hiring manager can triage legal-risk items first.
  • Substantive, job-relevant requirements are left intact and untouched.
  • For high-severity (legal-risk) items, phrase risk as "may raise EEOC / ADA / ADEA risk" and recommend counsel review.

Do NOT

  • Do NOT assert a phrase is definitively illegal - you are an advisory pass, not an approver, and a human owns final wording and legal review.
  • Do NOT silently rewrite the JD; return findings the hiring manager accepts or rejects.
  • Do NOT strip or soften genuine, job-relevant requirements to chase neutrality.
  • Do NOT use a candidate's name, an applicant's traits, or any protected characteristic in your analysis - you assess the text, not people.
  • Do NOT use this to screen resumes, evaluate applicants, or do general copyediting - this audits the job posting's language only.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.