text-classification

Classify social science text with LLMs using a defined codebook.

39|1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/scdenney/open-science-skills --skill text-classification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: text-classification
Source: https://github.com/scdenney/open-science-skills/tree/main/plugin/skills/text-classification
Command: npx skills add https://github.com/scdenney/open-science-skills --skill text-classification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Social science researchers often struggle to design and document rigorous, reproducible LLM-based text classification workflows. This Skill provides a structured blueprint for building such workflows, including codebook design, learning-regime selection, piloting, and transparent reporting.

Core Features & Use Cases

  • Codebook design guidance with five components per code: Label, Definition, Clarification, Negative clarification, and Examples.
  • Guidance on learning regimes (zero-shot, few-shot, fine-tuning, instruction-tuning) and model selection (open-weight vs proprietary) to optimize classification tasks.
  • Pilot testing and validation workflows against human ground truth, including inter-coder reliability considerations.
  • Hybrid human-LLM workflows for uncertain classifications and robust reporting practices.
  • Guidance on structured prompts and reproducibility documentation for publishable results.

Quick Start

Define your coding scheme using the five-code structure, choose a learning regime, run a 50–100 response pilot against human ground truth, and document the full pipeline.

Frequently Asked Questions about text-classification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a codebook for LLM-based text classification?

To design a codebook for LLM text classification, define five components for each code: Label, Definition, Clarification, Negative clarification, and Examples. This structured approach ensures explicit prompt construction and reproducible results.

What is the best way to validate LLM text classification against human ground truth?

The best way to validate LLM text classification is to run a 50–100 response pilot test against human ground truth. This workflow evaluates accuracy, considers inter-coder reliability, and supports hybrid human-LLM workflows for uncertain classifications.

How do I choose between open-weight and proprietary models for social science text classification?

Choosing between open-weight and proprietary models for social science text classification depends on your task's learning regime—zero-shot, few-shot, fine-tuning, or instruction-tuning—and your specific safety considerations and reproducibility requirements.

Can I use zero-shot learning for text classification without fine-tuning?

Yes, you can use zero-shot learning for text classification without fine-tuning. It is one of the supported learning regimes, alongside few-shot and instruction-tuning, allowing you to classify social science text based purely on prompt construction.

How do I document reproducibility for LLM text classification pipelines?

To document reproducibility for LLM text classification pipelines, report the full pipeline including codebook design, model selection, prompt construction, and pilot testing results. Transparent reporting practices ensure your social science findings are publishable.

When should I use hybrid human-LLM workflows for text classification?

You should use hybrid human-LLM workflows for text classification when handling uncertain classifications. This approach combines automated processing with human review to maintain high accuracy and robust reporting in social science research.