CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sr-screener

Protocol-driven study screening for systematic, scoping and rapid reviews. Turns a proposal or PROSPERO protocol into confirmed eligibility rules, then screens titles/abstracts and full texts with two blinded AI reviewers and a third-reviewer adjudicator: ordered exclusion codes, no silent defaults, resumable batch runs, QC (seed studies, near-miss rechecks, kappa and PABAK), PRISMA 2020 counts, EndNote/Zotero RIS groups, an Excel log, a methods draft and a literature_corpus handoff to academic-paper. Reads RIS, PubMed .nbib, Web of Science and CSV exports; removes duplicates. 8 modes: protocol, quick, pilot, ta-screen, ft-screen, adjudicate, audit, report. Use it to screen records against eligibility criteria, pilot screening, resolve screening conflicts, audit exclusions or report the selection process. Triggers on: screen these papers, title/abstract screening, full-text screening, screening conflicts, inclusion criteria, PRISMA flow, غربالگری مقالات, اسکرینینگ عنوان و چکیده, معیارهای ورود و خروج.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong operational skill body: fully executable script commands, an explicitly sequenced 7-phase workflow with hard validation checkpoints and error-recovery loops, and well-organized one-level-deep references that resolve for references/ and scripts/. The weaknesses are a body that is longer than it needs to be due to duplicated statements and suite-level routing content inlined in the SKILL.md, and several referenced bundle paths (agents, templates, examples, MODE_REGISTRY.md) that do not exist in the provided bundle.

Suggestions

Remove the duplicated statements: keep 'Screening starts only when the user asks for it' and the reviewer-independence rationale in one place each, cutting roughly a dozen lines without losing information.

Move the routing-core block and the instruction-data-boundary excerpt into a reference file (or link to shared/references/routing_core.md directly), keeping the SKILL.md focused on running the screening pipeline.

Either ship the referenced agents/, templates/, examples/ files and MODE_REGISTRY.md in the bundle, or drop/inline the references to them, so every path named in the Reference Files, Templates, Examples, and Agent File References tables resolves.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely skill-specific (no explanation of concepts Claude already knows), but at ~500 lines it could be tightened: "Screening starts only when the user asks for it" is stated twice (Screening boundary and the Checkpoints close), reviewer independence is justified both in the Agent Team section and anti-pattern 5, and the ~20-line routing-core block plus the instruction-data-boundary excerpt are suite-level orchestration content rather than skill operation. Not 4: these duplications and off-scope blocks are more than minor trimmable instances; not 2: the bulk of the text is operational, not padded explanation.

3 / 5

Actionability

Guidance is fully executable: a copy-paste bash sequence with exact flags ("python $S/prepare_records.py --inputs exports/ --work sr_work --config screening_config.json", "merge_decisions.py --work sr_work --from <run folder or journal.jsonl> --config screening_config.json --pilot-labels pilot_labels.csv"), a concrete per-role models JSON block, the per-record output contract "{id, d, code, why}", and named output files per mode. Not 4: commands and examples cover the common cases completely; placeholders like <this skill's folder> are unavoidable, not gaps.

5 / 5

Workflow Clarity

The 7-phase orchestration is explicitly sequenced, and the 7 numbered checkpoints are hard validation gates for batch operations: the pilot gate ("build_workflow.py ta refuses the full run... until every labelled record has been compared"), no-silent-defaults ("A record without a valid decision from each required reviewer stays pending"), cost check before fan-out, and error-recovery loops ("If a run stops... merge what exists, then run build_workflow.py --jobs pending", "stop, amend, re-pilot"). The Failure Paths table adds per-situation recovery steps. This is the anchor-5 pattern of explicit validation plus feedback loops.

5 / 5

Progressive Disclosure

Structure is good: the body is an overview with one-level-deep, clearly signaled references, and the Reference Files and Scripts tables map every file to its purpose; all 7 references/ files and all 6 scripts/ files referenced in the body exist in the bundle and match their descriptions (orchestration.md § 5 mode recipes, failure_paths.md F1-F15 verified). Not 5: the body also references agents/*.md (four agent files), templates/prompts.md, templates/screening_config.template.json, templates/workflows/*.js, examples/*, and MODE_REGISTRY.md, none of which are present in the bundle, so navigation breaks for those paths.

4 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: third-person voice, comprehensive concrete capability list, explicit use-when clause with concrete trigger phrases including multilingual synonyms and file formats. The only weakness is minor overlap risk with adjacent review-writing skills via shared trigger phrases like "inclusion criteria" and "PRISMA flow", which the description does not disambiguate.

DimensionReasoningScore

Specificity

The description lists many concrete actions with comprehensive coverage: "Turns a proposal or PROSPERO protocol into confirmed eligibility rules, then screens titles/abstracts and full texts", "ordered exclusion codes, no silent defaults, resumable batch runs, QC (seed studies, near-miss rechecks, kappa and PABAK), PRISMA 2020 counts, EndNote/Zotero RIS groups, an Excel log, a methods draft", plus input handling ("Reads RIS, PubMed .nbib, Web of Science and CSV exports; removes duplicates") and the 8 named modes. Not 4: the action inventory has no meaningful coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is a full capability and mode inventory, and the "when" is a dedicated "Use it to screen records against eligibility criteria, pilot screening, resolve screening conflicts, audit exclusions or report the selection process" clause followed by concrete trigger phrases. Not 4: the when-clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

"Triggers on: screen these papers, title/abstract screening, full-text screening, screening conflicts, inclusion criteria, PRISMA flow" covers the natural English phrases, and the Persian triggers (غربالگری مقالات, اسکرینینگ عنوان و چکیده, معیارهای ورود و خروج) plus named file formats (RIS, .nbib) give synonym- and extension-level coverage a real user would produce. Not 4: no common natural variant of the screening request is missing.

5 / 5

Distinctiveness Conflict Risk

The niche (protocol-driven screening as a distinct stage, with named handoffs to deep-research and academic-paper) is clear, but "inclusion criteria" and "PRISMA flow" are phrases a user asking for a whole systematic review or manuscript help would also naturally say, and the description does not state that boundary. Not 5: anchor 5 requires minimal conflict risk, and these shared phrases create minor overlap with the closely related deep-research systematic-review mode; not 3: the overlap is limited to closely related skills, not a broad set.

4 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (517 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

Imbad0202/academic-research-skills

Path

sr-screener/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.