Receber por email
← Voltar para o catálogo

screening-engine

Activate when the user needs to systematically screen papers for a Systematic Literature Review (SLR). Implements the PRISMA-compliant screening pipeline: define inclusion/exclusion criteria, title/abstract screening, full-text screening, quality assessment, and PRISMA flow diagram generation. Takes the literature_base.csv from Phase 1 (Reconnaissance) and produces a filtered, documented, auditabl

13estrelas
Atualizado há 6 meses

Ver no GitHub ↗ Licença: MIT

Como adicionar

/plugin marketplace add TobiasBlask/open-paper-machine

O comando exato pode variar conforme o repositório. Confira o README no GitHub.

Para o autor da skill

Cole no README do seu repo

Mostra que sua skill está catalogada na Skillteca, gera backlink e tráfego rastreável.

[![Skillteca](https://www.skillteca.com.br/api/badge/screening-engine/svg)](https://www.skillteca.com.br/skills/screening-engine)

Skills relacionadas

Ver todas de Documentos →

Alerta por categoria

Receba novas skills de Documentos toda segunda

1 email curto, só com as skills novas de Documentos. 4 minutos de leitura, sem spam, cancela com 1 clique.

Você confirma o email no primeiro envio. Sem spam. Cancela com 1 clique.

Ler descrição completa
Orchestration Log: When this skill is activated, append a log entry to outputs/orchestration_log.md:
```
### Skill Activation: Screening Engine
Timestamp: [current date/time]
Actor: AI Agent (screening-engine)
Input: [N] papers from literature_base.csv, [N] inclusion criteria, [N] exclusion criteria
Output: [N] papers included after screening, PRISMA diagram generated, screening_log.md saved
```

Screening Engine

Core Principle

A systematic literature review without documented screening is not systematic. This engine transforms the raw search results from Phase 1 (Reconnaissance) into a defensible, reproducible set of included studies. Every inclusion and exclusion decision is documented with a reason, producing the audit trail that reviewers and editors expect.

The screening process follows PRISMA 2020 (Page et al., 2021) and adapts the guidelines of vom Brocke et al. (2009, 2015) for IS research.

When to Activate

  • User is conducting a Systematic Literature Review (SLR)
  • User says "screen papers", "filter papers", "apply inclusion criteria"
  • User says "PRISMA", "screening process", "title/abstract screening"
  • After Phase 1 (Reconnaissance) when method is SLR
  • When literature_base.csv exists and needs systematic filtering
  • User runs /screen-papers

Prerequisites

  • literature_base.csv exists (from Phase 1 / literature-engine)
  • Research questions are defined (from Phase 2 / framing.md)
  • Target method is SLR (confirmed in Phase 2 or by user)

Step 1: DEFINE Inclusion/Exclusion Criteria

Criteria Template

Before screening begins, establish and document clear criteria:

## Screening Protocol

### Inclusion Criteria (IC)

| ID  | Criterion | Rationale | Operationalization |
|-----|-----------|-----------|-------------------|
| IC1 | Peer-reviewed journal article or conference paper (ICIS, ECIS, HICSS, AMCIS, or equivalent) | Quality assurance | Check venue against VHB-JOURQUAL, AIS proceedings, or established CS venues |
| IC2 | Focuses on [topic] in [context] | Scope alignment | Title/abstract must explicitly address [specific keywords] |
| IC3 | Published between [year] and [year] | Recency/coverage | Check publication date |
| IC4 | Available in English or German | Accessibility | Check language field |
| IC5 | Empirical or conceptual contribution | Substance | Must present findings, framework, or theory — not just opinion |

### Exclusion Criteria (EC)

| ID  | Criterion | Rationale | Operationalization |
|-----|-----------|-----------|-------------------|
| EC1 | Purely technical paper with no organizational/social dimension | Out of scope | No mention of users, organizations, processes, or adoption |
| EC2 | Editorial, book review, workshop abstract, poster, or abstract-only | Insufficient depth | Less than 4 pages or no methodology section |
| EC3 | Duplicate or earlier version of an included paper | Avoid double-counting | Same authors + overlapping content → keep most recent/complete |
| EC4 | Not accessible (no abstract, no full text, no DOI) | Cannot assess | Exhausted all retrieval options |

Criteria Derivation

Criteria should be derived from:

  1. Research questions — IC2 must map directly to what the RQs ask
  2. Scope boundaries — What explicitly falls outside the study
  3. Quality thresholds — Minimum venue quality, minimum methodological rigor
  4. Practical constraints — Language, accessibility, date range

Present the criteria table to the user for approval before proceeding. This is a quality gate — criteria should not change after screening begins (or changes must be documented as protocol amendments).

Step 2: TITLE/ABSTRACT SCREENING

Process

For each paper in literature_base.csv:

  1. Read title and abstract (abstract from CSV or fetched via API)
  2. Apply each criterion in sequence (IC1 → IC5, then EC1 → EC4)
  3. Decision: INCLUDE, EXCLUDE, or UNCERTAIN
  4. Record reason for exclusion (cite the specific criterion ID)

Decision Rules

  • INCLUDE if: Title and abstract suggest the paper meets ALL inclusion criteria AND violates NO exclusion criteria
  • EXCLUDE if: Title and abstract clearly violate at least one criterion
  • UNCERTAIN if: Cannot determine from title/abstract alone → move to full-text screening
  • When in doubt, include — it's better to over-include at this stage and exclude during full-text review

Handling Missing Abstracts

If a paper has no abstract in literature_base.csv:

  1. Attempt to fetch via Semantic Scholar API (by DOI or title)
  2. Attempt to fetch via OpenAlex API
  3. If still no abstract: mark as UNCERTAIN → include for full-text screening
  4. If no full text available either: mark as EXCLUDE with reason EC4

Output Format

For each paper, record:

{
  "id": "[CSV row or bib_key]",
  "title": "[paper title]",
  "authors": "[first author et al.]",
  "year": [year],
  "venue": "[venue]",
  "screening_decision": "INCLUDE" | "EXCLUDE" | "UNCERTAIN",
  "exclusion_reason": "EC2" | null,
  "exclusion_detail": "Workshop abstract, 2 pages, no methodology" | null,
  "screener_note": "[optional note]"
}

Batch Processing

Process papers in batches of 20-30. After each batch:

  • Report progress: "Screened [N]/[total]. Included: [n], Excluded: [n], Uncertain: [n]"
  • Save intermediate results to screening/title_abstract_screening.csv
  • Continue unless the user intervenes

Step 3: FULL-TEXT SCREENING

When to Apply

Full-text screening is performed on:

  1. All papers marked INCLUDE after title/abstract screening
  2. All papers marked UNCERTAIN after title/abstract screening

Process

For each paper:

  1. Obtain full text:
  2. Check if PDF is available (open access, arXiv, institutional access)
  3. If PDF available: read introduction, methodology, and conclusion sections
  4. If only abstract available: make decision based on abstract + metadata
  1. Apply criteria with full context:
  2. Does the paper actually address the topic (not just mention keywords)?
  3. Does it have a clear methodology section?
  4. Does it present findings relevant to the RQs?
  5. Is the venue quality sufficient?
  1. Decision: INCLUDE or EXCLUDE (no more UNCERTAIN at this stage)
  2. Record reason for exclusion with specific detail

Exclusion Reason Categories for Full-Text

Track exclusion reasons to report in the PRISMA diagram:

| Reason Category | Example | |----------------|---------| | Wrong population/context | Studies AI in healthcare, not enterprise context | | Wrong intervention/topic | Focuses on AI ethics, not implementation | | Wrong outcome | Measures technical performance, not organizational impact | | Wrong study type | Opinion piece, no empirical or conceptual contribution | | Insufficient quality | No clear methodology, weak evidence base | | Duplicate/superseded | Earlier version of an already-included paper | | Not accessible | Cannot obtain full text despite best efforts |

Output

Save to screening/full_text_screening.csv with the same format as title/abstract screening, plus:

  • full_text_available: true/false
  • full_text_exclusion_category: one of the categories above

Step 4: QUALITY ASSESSMENT

Purpose

After the final set of included papers is determined, assess their methodological quality. This is NOT an inclusion/exclusion step — it's a characterization that informs the synthesis (e.g., weighting findings from high-quality studies more).

Quality Checklist (adapted for IS research)

For each included paper, assess:

| Criterion | Assessment | Notes | |-----------|-----------|-------| | Q1: Clear research objective/question stated? | Yes / Partial / No | | | Q2: Appropriate methodology for the research goal? | Yes / Partial / No | | | Q3: Data collection described adequately? | Yes / Partial / No / N/A | | | Q4: Data analysis described adequately? | Yes / Partial / No / N/A | | |

Compartilhar X LinkedIn