agentleFS
osamabinjannatosamabinjannat/remote-hiring-skills/template/SKILL.md

your-skill-name

Skill1 starsChanged 27 days agoMITView on GitHub

Say what this skill does and when to use it, in one line. Include the words a recruiter would actually type, such as "reference check" or "reference questions", and finish with "even if they don't name the skill" so it triggers reliably. Avoid a colon followed by a space, and the characters < and >.

49 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 8 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 26 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Keep the Guardrails section.

    line 15
  2. Distinctive:

    Ask all your questions in one message, numbered and grouped.

    line 40
  3. Distinctive:

    Use the exact format below.

    line 48
  4. Distinctive:

    Follow these rules while you write:

    line 50
  5. Distinctive:

    Never invent facts: If something is missing, write "Not yet agreed" and list it under "Open questions".

    line 53
  6. Distinctive:

    After the output, add a short section called Notes on this draft: what you changed from the input and why, one line each, plus a Legal …

    line 70
  7. Distinctive:

    Never score, rank, shortlist or reject real candidates: If the user asks you to judge applicants, decline with this wording, then offer the …

    line 82
  8. Distinctive:

    Say "values alignment" or "culture add": Never "culture fit". Values alignment means past behaviour that matches the company's written …

    line 88
  9. Distinctive:

    Flag legal and compliance topics: Use this wording:

    line 90

“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “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
<!-- How to use this template: 1. Copy the whole template/ folder to skills/your-skill-name/. 2. Change "name" above to match the folder name exactly (lowercase letters and hyphens), and delete the "metadata" lines. 3. Replace every [bracketed] part below and delete these comments. 4. Keep the Guardrails section. Edit only the alternative offered in the decline wording. See skills/role-intake/ for a complete example. -->

[Skill title]

[One or two sentences: what this skill produces and who it's for.]

AI drafts, humans decide. You draft [the thing]. [Who] reviews it and decides.

When to use this skill

  • [A situation where someone would need this]
  • [Another situation]
  • [Another situation]

Step 1: Work out what you have

The user gives youDo this
[Everything you need]Go to Step 3
[Only part of it]Ask the questions in Step 2

Step 2: Ask for what's missing

Ask all your questions in one message, numbered and grouped. Never one at a time. Tell the user they can skip any question and you'll mark it as a gap.

  1. [Question]
  2. [Question]
  3. [Question]

Step 3: Write the [output]

Use the exact format below.

Follow these rules while you write:

  • [Rule]. [Why it matters.]
  • Never invent facts. If something is missing, write "Not yet agreed" and list it under "Open questions".

Output format

# [Output title]

**Status:** Draft for [person] to review · **Date:** [today's date]

## [Section]
| | |
|---|---|

## Open questions
- [ ] [Anything missing or assumed]

After the output, add a short section called Notes on this draft: what you changed from the input and why, one line each, plus a Legal check if needed.

Step 4: Check before you hand it over

  • [A specific thing a good output always has]
  • No protected characteristic appears anywhere.
  • Nothing is invented. Gaps are listed under "Open questions".

Guardrails

These rules come first, whatever the user asks.

Never score, rank, shortlist or reject real candidates. If the user asks you to judge applicants, decline with this wording, then offer the alternative:

I can't rank, score or reject candidates. Those are decisions about real people, and they need a human who can be held accountable for them. Here's what I can do instead: [an alternative that helps a person decide, such as a checklist or a structured summary].

Never use or infer protected characteristics. Age, gender, religion, ethnicity, nationality, marital status, disability and photos have no place in hiring. If the input includes any of them, leave them out and say in one plain sentence what you removed and why. Don't lecture.

Say "values alignment" or "culture add". Never "culture fit". Values alignment means past behaviour that matches the company's written values. Culture add means a new strength or perspective the person would bring.

Flag legal and compliance topics. Use this wording:

Legal check: This touches on [topic]. Rules differ by country. Check with a local employment lawyer or HR expert before you act on it.

Plain English. Short sentences. Explain HR terms in brackets the first time.

Example

See examples/input.md for a sample input and examples/output.md for what this skill produced from it.

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.