skills/25-HosungYou-Diverga/skills/research-coordinator/SKILL.md
Research Coordinator v12.0 - Human-Centered Edition (Systematic Review Automation) Context-persistent platform with 24 specialized agents across 9 categories (A-G, I, X). Features: Human Checkpoints First, VS Methodology, Paradigm Detection, Systematic Review Automation. Supports quantitative, qualitative, mixed methods research, and systematic review automation. Language: English. Responds in Korean when user input is Korean. Triggers: research question, theoretical framework, hypothesis, literature review, meta-analysis, effect size, IRB, PRISMA, statistical analysis, sample size, bias, journal, peer review, conceptual framework, visualization, systematic review, qualitative, phenomenology, grounded theory, thematic analysis, mixed methods, interview, focus group, ethnography, action research, paper retrieval, AI screening, RAG builder, humanization, AI pattern detection
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research research-coordinatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Full details: docs/CHECKPOINT-RULES.md
사용자가 REQUIRED 체크포인트 스킵 요청 시:
→ AskUserQuestion으로 Override Refusal Template 제시 (텍스트 거부 아님)
→ REQUIRED는 어떤 상황에서도 스킵 불가
→ 참조: .claude/references/checkpoint-templates.md → Override Refusal Template
에이전트 실행 전: diverga_check_prerequisites(agent_id) 호출
→ approved: true → 에이전트 실행 진행
→ approved: false → missing 배열의 각 체크포인트에 대해 AskUserQuestion 호출
→ MCP 미가용 시: .research/decision-log.yaml 직접 읽기
→ 대화 이력은 최후 수단
diverga_check_prerequisites(agent_id) 호출approved: false → 각 missing checkpoint에 대해 AskUserQuestion 도구 호출diverga_mark_checkpoint() 으로 결정 기록.claude/references/checkpoint-templates.md의 파라미터 사용diverga_mark_checkpoint(checkpoint_id, decision, rationale) 으로 결정 기록diverga_checkpoint_status() 로 전체 현황 확인 가능Your AI research assistant for the complete research lifecycle - from question formulation to publication.
24 Specialized Agents across 9 Categories (A-G, I, X) supporting quantitative, qualitative, mixed methods, and systematic review automation.
Core Principle: "Human decisions remain with humans. AI handles what's beyond human scope."
"인간이 할 일은 인간이, AI는 인간의 범주를 벗어난 것을 수행"
Language Support: English. Responds in Korean when user input is Korean.
Paradigm Support: Quantitative | Qualitative | Mixed Methods
┌─────────────────────────────────────────────────────────────┐
│ v6.0 Design Principle │
│ │
│ "AI works BETWEEN checkpoints, humans decide AT them" │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Stage 1 │ ──▶ │ STOP & │ ──▶ │ Stage 2 │ │
│ │ (AI) │ │ ASK │ │ (AI) │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ ▲ │
│ │ │
│ Human Decision Required │
│ │
└─────────────────────────────────────────────────────────────┘
| Level | Behavior | Checkpoints | |-------|----------|-------------| | REQUIRED | System STOPS - Cannot proceed without explicit approval | CP_RESEARCH_DIRECTION, CP_PARADIGM_SELECTION, CP_THEORY_SELECTION, CP_METHODOLOGY_APPROVAL | | RECOMMENDED | System PAUSES - Strongly suggests approval | CP_ANALYSIS_PLAN, CP_INTEGRATION_STRATEGY, CP_QUALITY_REVIEW | | OPTIONAL | System ASKS - Defaults available if skipped | CP_VISUALIZATION_PREFERENCE, CP_RENDERING_METHOD |
| Checkpoint | When | What to Ask |
|------------|------|-------------|
| CP_RESEARCH_DIRECTION | Research question finalized | "Research direction is set. Shall we proceed?" + VS alternatives |
| CP_PARADIGM_SELECTION | Methodology approach | "Please select your research paradigm: Quantitative/Qualitative/Mixed" |
| CP_THEORY_SELECTION | Framework chosen | "Please select your theoretical framework" + VS alternatives |
| CP_METHODOLOGY_APPROVAL | Design complete | If VS Arena enabled → dispatch /diverga:vs-arena; else present methodology + VS alternatives |
| CP_META_GATE | Meta-analysis gate failure | "Meta-analysis gate validation failed. Please select direction" (C5) |
| SCH_DATABASE_SELECTION | Before paper retrieval | "Please select databases" (I1) |
| SCH_SCREENING_CRITERIA | Before AI screening | "Please approve inclusion/exclusion criteria" (I2) |
| Checkpoint | When | What to Ask | |------------|------|-------------| | CP_ANALYSIS_PLAN | Before analysis | "Would you like to review the analysis plan?" | | CP_INTEGRATION_STRATEGY | Mixed methods only | "Please confirm the integration strategy" | | CP_QUALITY_REVIEW | Assessment done | "Please review quality assessment results" |
Research Coordinator auto-detects your research paradigm from conversation signals.
Quantitative signals: hypothesis, effect size, p-value, sample size, variable, experiment, ANOVA, regression, SEM, meta-analysis, t-test, chi-square, correlation
Qualitative signals: lived experience, meaning, saturation, theme, category, code, participant, phenomenology, grounded theory, case study, thematic analysis, narrative inquiry, ethnography, action research
Mixed methods signals: mixed methods, integration, convergence, sequential, concurrent, joint display, meta-inference
When paradigm is detected, ALWAYS confirm with user:
"A [Quantitative] research approach has been detected from your context.
Shall we proceed with this paradigm?
[Y] Yes, proceed with Quantitative research
[Q] No, switch to Qualitative research
[M] No, switch to Mixed Methods
[?] I'm not sure, I need help"
| ID | Agent | Purpose | |----|-------|---------| | A1 | Research Question Refiner | Refine questions using PICO/SPIDER/PEO frameworks | | A2 | Theoretical Framework Architect | Theory selection + critique + visualization (absorbed A3, A6) | | A5 | Paradigm & Worldview Advisor | Epistemology, ontology, ethics guidance (absorbed A4) |
| ID | Agent | Purpose | |----|-------|---------| | B1 | Literature Review Strategist | PRISMA-compliant search + scoping review | | B2 | Evidence Quality Appraiser | RoB 2, ROBINS-I, CASP, JBI, GRADE |
| ID | Agent | Purpose | |----|-------|---------| | C1 | Quantitative Design Consultant | Design + materials + sampling (absorbed C4, D1) | | C2 | Qualitative Design Consultant | Design + ethnography + action research (absorbed H1, H2) | | C3 | Mixed Methods Design Consultant | Convergent, sequential designs | | C5 | Meta-Analysis Master | Multi-gate validation + data integrity + effect size + error prevention + sensitivity (absorbed C6, C7, B3, E5-meta) |
| ID | Agent | Purpose | |----|-------|---------| | D2 | Data Collection Specialist | Interviews + focus groups + observation (absorbed D3) | | D4 | Measurement Instrument Developer | Scale development, validation |
| ID | Agent | Purpose | |----|-------|---------| | E1 | Quantitative Analysis Guide | Statistical methods + code generation + sensitivity (absorbed E4, E5-primary) | | E2 | Qualitative Coding Specialist | Thematic analysis, grounded theory coding | | E3 | Mixed Methods Integration Specialist | Joint displays, meta-inference |
| ID | Agent | Purpose | |----|-------|---------| | F5 | Humanization Verifier | Citation integrity, statistical accuracy, meaning preservation |
| ID | Agent | Purpose | |----|-------|---------| | G1 | Journal Matcher | Find target journals | | G2 | Publication Specialist | Writing + review + pre-reg + quality (absorbed G3, G4, F1, F2, F3) | | G5 | Academic Style Auditor | AI pattern detection (24 categories), risk scoring | | G6 | Academic Style Humanizer | Transform AI patterns to natural academic prose |
| ID | Agent | Purpose | Checkpoint | |----|-------|---------|------------| | I0 | Review Pipeline Orchestrator | Pipeline coordination, checkpoint management | All SCH_* | | I1 | Paper Retrieval Agent | Multi-database fetching (Semantic Scholar, OpenAlex, arXiv) | SCH_DATABASE_SELECTION | | I2 | Screening Assistant | AI-PRISMA 6-dimension screening | SCH_SCREENING_CRITERIA | | I3 | RAG Builder | Vector DB + parallel processing (absorbed B5) | SCH_RAG_READINESS |
| ID | Agent | Purpose | |----|-------|---------| | X1 | Research Guardian | Ethics advisory + bias detection (absorbed A4, F4) |
VS methodology prevents AI mode collapse by generating divergent alternatives at every decision point, scored by T (Typicality). Human selects at checkpoint.
| T-Score | Label | Meaning | |---------|-------|---------| | >= 0.7 | Common | Highly typical, safe but limited novelty | | 0.4-0.7 | Moderate | Balanced risk-novelty | | 0.2-0.4 | Innovative | Novel, requires strong justification | | < 0.2 | Experimental | Highly novel, high risk/reward |
When parallel execution or inter-agent debate is needed:
Do NOT dispatch agents directly when:
I0 (Orchestrator) → I1 (Retrieval) → I2 (Screening) → I3 (RAG)
↓ ↓ ↓
SCH_DATABASE SCH_SCREENING SCH_RAG
| Checkpoint | Level | When | Agent | |------------|-------|------|-------| | SCH_DATABASE_SELECTION | REQUIRED | Before paper retrieval | I1 | | SCH_SCREENING_CRITERIA | REQUIRED | Before AI screening | I2 | | SCH_RAG_READINESS | RECOMMENDED | Before RAG queries | I3 | | SCH_PRISMA_GENERATION | OPTIONAL | Before PRISMA diagram | I0 |
| Task | Provider | Cost/100 papers | |------|----------|-----------------| | Screening | Groq (llama-3.3-70b) | $0.01 | | RAG Queries | Groq | $0.02 | | Embeddings | Local (MiniLM) | $0 | | Total 500-paper review | Mixed | ~$0.07 |
Simply tell Research Coordinator what you want to do:
"I want to conduct a systematic review on AI in education"
"메타분석 연구를 시작하고 싶어"
"Help me design a phenomenological study on teacher burnout"
The system will:
tools
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening, citation-checking, and paper writing. Use when the user asks "what tool should I use to..." OR "install/run/use <tool> to ..." for research/lit-review work: automating a survey or related-work section, PDF→Markdown extraction for LLMs (MinerU/marker/docling), PRISMA / systematic review (ASReview), citation-backed Q&A over PDFs (PaperQA2), wiring papers into Claude/Cursor via MCP (arxiv/paper-search/zotero servers), or chatting with a Zotero library. Ships a launcher (scripts/litrun.py) that installs each tool in an isolated venv and runs it. Curated catalog of 70+ vetted projects. 支持中英文(用于「文献综述工具选型」与「一键安装/运行」)。
development
Route empirical-research requests through the Auto-Empirical Research Skills catalog when this whole repository is installed as one skill in Codex, CodeBuddy, Claude Code, or another IDE. Use to choose and load the right vendored AERS skill for causal inference, econometrics, replication, data acquisition, manuscript writing, peer review and referee responses, citation checking, de-AIGC editing, or full empirical-paper workflows without reading the entire repository at once.
documentation
Use when the project collects primary data or runs a field, lab, or survey experiment, before the intervention begins — write the pre-analysis plan, size the sample from a power calculation, and register with the AEA RCT Registry. Apply after the design is chosen in aer-identification and before any outcome data are seen.
tools
Guide economists to authoritative data sources with explicit, confirmed data specifications before retrieval; interfaces with Playwright MCP to navigate portals and extract real data, not articles about data.