building-screening-rubrics

Build and validate paper screening rubrics through test-driven iterative refinement.

850|114|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/wentorai/Research-Claw --skill building-screening-rubrics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-screening-rubrics
Source: https://github.com/wentorai/Research-Claw/tree/main/skills/building-screening-rubrics
Command: npx skills add https://github.com/wentorai/Research-Claw --skill building-screening-rubrics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Screening hundreds of papers for a literature review often produces misclassifications when relevance criteria are vague or untested. This Skill builds a scoring rubric collaboratively, validates it against user-labeled test papers, and iterates until accuracy reaches at least 80% before bulk screening.

Core Features & Use Cases

  • Collaborative Rubric Design: Brainstorms keywords, data types, paper types, and edge cases with the user, then encodes them as weighted scoring rules in screening-criteria.json.
  • Test-Driven Validation: Fetches candidate abstracts via Scopus and OpenAlex, collects user judgments on 5-10 papers, scores them with the rubric, and reports false positives and false negatives.
  • Bulk Screening and Re-screening: Applies the validated rubric to full result sets, caches abstracts, and re-scores all cached papers when criteria change, producing a diff of status changes.
  • Use Case: A researcher screening 127 papers on tuberculosis drug resistance builds a rubric, fixes misclassifications around analog and derivative terminology, reaches 90% test accuracy, then screens the full set and re-screens after adding combination-therapy terms.

Quick Start

Help me build a screening rubric for my literature search on tuberculosis drug resistance and validate it on test papers before screening all results.

Frequently Asked Questions about building-screening-rubrics

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

FAQPage Schema
How do I build a paper screening rubric for a literature review?

Start by brainstorming core keywords, synonyms, exclusion terms, data types, and paper types with the user, then encode them as weighted scoring rules in screening-criteria.json. Validate the rubric on 5-10 user-classified test papers and iterate until accuracy reaches at least 80%.

How to test screening criteria before bulk screening papers?

Run a Scopus search for about 20 candidate papers, present abstracts to the user for relevance judgments, then score those papers with the rubric and compare predictions against user labels. Analyze false positives and false negatives to refine weights and special rules.

When should I not use an automated screening rubric?

Skip rubric building for small searches under 20 papers where manual screening is faster, for one-off exploratory searches, or when an existing rubric already classifies well. The test-driven process is designed for screening 50 or more papers.

Can I re-screen papers after updating my relevance criteria?

Yes. All abstracts are cached in abstracts-cache.json, so an updated rubric can be re-applied to every cached paper without re-fetching. The workflow generates a change report showing which papers shifted status between rubric versions.

Why does my screening rubric misclassify relevant papers?

False negatives usually come from missing synonyms or overly narrow special rules, such as requiring the word analog when papers say derivative. False positives often come from giving review papers too many specificity points when only primary research is wanted.