Install any skill in seconds. Free to start, no credit card required.
Get Started Free →brycewang-stanford/text-classification
LLM-based text classification: codebook, validation, agreement statistics.
Passed 20 of 22 test cases with the skill, and 15 of 22 without it.
and 6 more in the full report
6 fixed14 passed either way1 still failing1 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.
I am preparing to classify 5,000 open-ended survey responses about local environmental policies using LLMs. Could you outline a comprehensive workflow for creating a rigorous codebook and setting up the prompt architecture? I specifically need step-by-step guidance on what components each code definition must contain to minimize model ambiguity, how to structure the system prompt for consistent output, and what label-free behavioral diagnostic tests I should run on the model before spending resources on human hand-labeling.
| Checked | Without skill | With skill |
|---|---|---|
| Specifies that each code must include label, single-sentence definition, clarification, negative clarification, and 2-3 positive and negative examples. | Missed | Passed |
| Includes Stage 1 label-free tests for legal labels, definition recovery, in-context example classification, and codebook order invariance. | Missed | Passed |
The instructions your model reads when the skill loads.
none_of_above or uncodeable) for responses that are too vague, too short, or off-topic. Define this category as precisely as the substantive codes (Halterman & Keith 2025).reference/example-codebook-and-prompt.md.Follow the decision framework from Chae & Davidson (2025), which maps document characteristics and available resources to the appropriate approach:
Zero-shot prompting: Use when classifying short documents with a large decoder model (GPT-4o, Llama3-70B+) and no labeled training data. Best for rapid prototyping and tasks where constructs are well-defined. GPT-4o achieves the best zero-shot performance across tasks (Chae & Davidson 2025).
Few-shot prompting: Add labeled examples to the prompt. Results are inconsistent — adding examples helps some models but degrades others (Chae & Davidson 2025). Always compare few-shot against zero-shot on a held-out sample before committing. Select diverse examples covering edge cases, not just prototypical instances.
Fine-tuning: Train a model on labeled data. Effective with as few as 100 hand-coded examples for smaller models (Chae & Davidson 2025). Fine-tuned smaller models (Llama3-8B, GPT-3 Davinci) can match GPT-4o zero-shot performance. Prefer this when you have labeled data and need cost-effective classification at scale.
Instruction-tuning: Combine detailed prompting with fine-tuning on paired instruction-output examples. Most powerful regime for complex tasks — instruction-tuned Llama3-70B surpasses GPT-4o zero-shot on stance detection (Chae & Davidson 2025). Requires more technical infrastructure but yields the highest accuracy.
Encoder-only fine-tuning: A distinct fourth regime often omitted from generative-LLM discussions. Fine-tuning a smaller encoder-only model (BERT, DeBERTa, SBERT; ~86–110M parameters, personal-computer hardware) on modest labeled data can match or exceed zero-shot generative LLMs on many classification tasks at a fraction of the cost and with fully reproducible (deterministic) output (Chae & Davidson 2025, Table 1; Ziems et al. 2024 find fine-tuned RoBERTa rarely under-performs larger generative models across 20 tasks). Prefer encoder fine-tuning when the label set is fixed, labeled data exists, and reproducibility matters more than generative flexibility.
When resources permit, test multiple regimes on the same pilot sample and select based on empirical performance, not assumptions.
gpt-4o-2024-08-06), not the model family name. Commercial models are modified or deprecated without notice — GPT-3 was withdrawn from OpenAI's API entirely (Barrie, Palmer & Spirling 2025; Chae & Davidson 2025).test cases passed, vs 15 / 22 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.