Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Turns a labeling or annotation task into a guideline different annotators can apply the same way — label definitions with explicit in/out boundaries, a worked borderline example for each label, a tie-break rule for when two labels fit or a case is unclear, canonical gold examples, and an agreement check across annotators. Use when someone is setting up a labeling, tagging, annotation, or coding task for a dataset and wants the instructions or rubric to hand to labelers. Do NOT use for building or training the classifier itself, for cleaning or deduplicating already-labeled data, or for writing end-user content policy rather than annotator instructions.
.claude/skills/dataset-labeling-guidelines/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 512% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 544% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 560% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 550% | 0% |
| case-09 | ✗→✓ | ▲ Improved | 556% | 0% |
Asked to write instructions for labeling a dataset, the base model tends to produce a thin rubric: a list of label names with a one-line gloss each, no boundaries, no examples of the hard cases, and no rule for what an annotator does when stuck. Handed to two people, that rubric produces two different datasets — the disagreement lands in the middle, exactly where the one-liners run out. The label noise this creates propagates into whatever model trains on the data.
A usable guideline is the discipline that professional annotation teams follow: definitions drawn at the boundary, the hard cases worked out in advance, a decision rule for ties, canonical examples, and a way to measure whether annotators actually agree. This skill supplies that structure.
Every labeling guideline needs all six parts below. The base supplies the first (label names) by default and skips the rest — those are where consistency is won.
A name ("negative", "urgent", "spam") is not a definition. State what falls inside the label and what falls outside it — especially against the adjacent label it is most often confused with. The boundary between two labels is where annotators disagree, so that is what the definition must pin down.
> Labeling a piece of writing as opinion / reporting / mixed: > - reporting — states verifiable facts and attributes them to sources; contains no evaluative language from the author. Excludes pieces that draw a conclusion the sources did not state. > - opinion — the author argues for a position or makes value judgments. Excludes pieces that merely quote someone else's opinion while staying neutral. > - mixed — both a factual core and the author's own argument are present and neither is incidental.
Aim for labels that are mutually exclusive (a case fits one) and exhaustive (every case fits some label — add an other / none label if not).
For every label, include at least one borderline example — a case that looks like it could be something else — and show which label it takes and why. Edge cases are the actual content of a guideline; the obvious cases never needed instructions.
> - "Officials said the policy will save money." → reporting (attributed factual claim, no authorial judgment), not opinion, even though it sounds favorable. > - "This reckless policy will bankrupt us." → opinion (value words "reckless", "bankrupt" are the author's), not reporting.
Annotators freeze on the ambiguous middle. Remove the freeze with an explicit rule. Two standard forms:
other / unsure." (Use so genuinely ambiguous cases collect in one predictable place instead of being split randomly.)State plainly what to do when the case matches no label, too. Never leave "what if I'm not sure" unanswered — that silence is where consistency dies.
For each label, give one or two canonical, unambiguous examples — the clearest possible instance. New annotators calibrate against these, and they double as the answer key for onboarding. Keep exemplars separate from the edge cases: exemplars show the center of a label, edge cases show its border.
Name the exact label set (and whether an item can take more than one label). If labels are ordered (e.g. severity 1–5), say what each level means at the anchor points, not just the endpoints. Ambiguity about which labels exist is a silent source of disagreement.
A guideline is unverified until two or more annotators independently label the same sample and you measure how often they match. This is the step the base always omits.
Deliver the guideline as a document an annotator can work straight from:
markdown## Task [one sentence: what is being labeled and the exact label set] ## Labels ### <label> — <one-line definition> Include: … / Exclude: … (boundary vs the nearest other label) Gold example: … Edge case: <borderline item> → this label, because … [repeat per label] ## When unsure [tie-break / priority order / default label; what to do if nothing fits] ## Agreement check [how many items double-labeled, by whom, which metric, the target, what to do if it's low]
A good execution of this skill should:
Other measured skills in the registry, with their headline benchmark lift.