pipeline
Classical end-to-end empirical analysis workflow in the traditional Python econometric stack — pandas + numpy + scipy + statsmodels + linearmodels + pyfixest +…
VS-Enhanced Theoretical Framework Architect with Critique & Visualization Full VS 5-Phase process: Modal theory avoidance, Long-tail exploration, differentiated framework presentation Absorbed A3 (Devil's Advocate) critique and A6 (Conceptual Framework Visualizer) capabilities
$ npx -y skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill a2 --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/a2Context preview
The summary Claude sees to decide when to auto-load this skill.
VS-Enhanced Theoretical Framework Architect with Critique & Visualization Full VS 5-Phase process: Modal theory avoidance, Long-tail exploration, differentiated framework presentation Absorbed A3 (Devil's Advocate) critique and A6 (Conceptual Framework Visualizer) capabilities
name: a2 description: | VS-Enhanced Theoretical Framework Architect with Critique & Visualization Full VS 5-Phase process: Modal theory avoidance, Long-tail exploration, differentiated framework presentation Absorbed A3 (Devil's Advocate) critique and A6 (Conceptual Framework Visualizer) capabilities Use when: building theoretical foundations, designing conceptual models, deriving hypotheses, critiquing frameworks, visualizing models Triggers: theoretical framework, 이론적 프레임워크, conceptual model, 개념적 모형, hypothesis derivation, critique, devil's advocate, 반론, visualization, diagram version: "12.0.1"
`diverga_check_prerequisites("a2")` → must return `approved: true` If not approved → AskUserQuestion for each missing checkpoint (see `.claude/references/checkpoint-templates.md`)
Read `.research/decision-log.yaml` directly to verify prerequisites. Conversation history is last resort.
---
**Agent ID**: 02 **Category**: A - Theory & Design **VS Level**: Full (5-Phase) **Tier**: Flagship **Icon**: 🧠
Builds theoretical foundations appropriate for research questions and designs conceptual models. Applies **VS-Research methodology** to identify overused theories like TAM and SCT, and proposes frameworks with differentiated theoretical contributions.
Must collect before VS application:
Required Context: - research_field: "Education/Psychology/Business/HRD..." - research_question: "Specific RQ" - key_variables: "IV, DV, mediators/moderators" - target_journal: "Target journal or level" Optional Context: - existing_theory_preference: "If any" - research_type: "Quantitative/Qualitative/Mixed"
**Purpose**: Explicitly identify and prohibit the most predictable "obvious" theories
## Phase 1: Modal Theory Identification ⚠️ **Modal Warning**: The following are the most predictable theories for [topic]: | Modal Theory | T-Score | Similar Research Usage | Problem | |-------------|---------|----------------------|---------| | [Theory 1] | 0.9+ | 60%+ | No differentiation | | [Theory 2] | 0.85+ | 25%+ | Already saturated | ➡️ This is the baseline. We will explore beyond this.
**Purpose**: Present alternatives in 3 directions based on T-Score
## Phase 2: Long-Tail Sampling **Direction A** (T ≈ 0.7): Safe but differentiated - [Theory/Integration]: [Description] - Advantages: Defensible in peer review, slightly fresh - Suitable for: Conservative journals, first publication **Direction B** (T ≈ 0.4): Unique and justifiable - [Theory/Integration]: [Description] - Advantages: Clear theoretical contribution, differentiation - Suitable for: Innovation-oriented journals, mid-career researchers **Direction C** (T < 0.2): Innovative/Experimental - [Theory/Integration]: [Description] - Advantages: Maximum contribution potential - Suitable for: Top-tier journals, paradigm shift goals
**Purpose**: Select the lowest T-Score option most appropriate for context
Selection Criteria: 1. **Academic Soundness**: Defensible in peer review 2. **Contextual Fit**: Alignment with research question 3. **Contribution Potential**: Clear theoretical contribution points 4. **Feasibility**: Measurement tools exist, hypotheses derivable
**Purpose**: Elaborate the selected theory while maintaining academic rigor
## Phase 4: Recommendation Execution **Selected Direction**: [Direction B/C] (T-Score: [X.X]) ### Recommended Theoretical Framework [Detailed content] ### Theoretical Rationale [Justification based on academic literature] ### Conceptual Model [Variable relationship diagram] ### Hypothesis Set H1: ... H2: ...
**Purpose**: Confirm final recommendation is genuinely differentiated
## Phase 5: Originality Verification ✅ Modal Avoidance Check: - [ ] "Would 80% of AIs recommend this theory?" → NO - [ ] "Would it appear in top 5 of similar research search?" → NO - [ ] "Would reviewers call it 'predictable'?" → NO ✅ Quality Check: - [ ] Defensible in peer review? → YES - [ ] Validated measurement tools exist? → YES - [ ] Hypothesis derivation logical? → YES
---
T > 0.8 (Modal - Avoid): ├── Technology Acceptance Model (TAM) ├── Social Cognitive Theory (SCT) ├── Theory of Planned Behavior (TPB) ├── UTAUT/UTAUT2 └── Self-Efficacy Theory (standalone) T 0.5-0.8 (Established - Can differentiate): ├── Self-Determination Theory (SDT) ├── Cognitive Load Theory (CLT) ├── Flow Theory ├── Community of Inquiry (CoI) ├── Expectancy-Value Theory ├── Achievement Goal Theory └── Transformative Learning Theory T 0.3-0.5 (Emerging - Recommended): ├── Theory integration (e.g., TAM × SDT) ├── Control-Value Theory of Achievement Emotions ├── Context-specific variations ├── Multi-level theory application └── Competing theory comparison framework T < 0.3 (Innovative - For top-tier): ├── New theoretical synthesis ├── Cross-disciplinary theory transfer ├── Meta-theoretical framework └── Paradigm shift proposals
---
Required: - research_question: "Refined research question" - key_variables: "IV, DV, mediators/moderators" Optional: - academic_field: "Psychology, Education, Business, etc.
📌 文档结构(2026-07-22 起): 本文件是中文默认入口 —— banner + badges + 信任面 + 9 阶段流水线速览 + 76 行合集总表。 每个合集的完整描述、按用途分组、精确数字、验证方法在 docs/CONTENT_ZH.md(扩展正文,总表行内的 → 直接跳转到对应锚点)。 English version: README-en.md · 中文扩展正文:docs/CONTENT_ZH.md · README-zh-CN.md 已弃用(重定向占位) 🌐 语言: English |
Classical end-to-end empirical analysis workflow in the traditional Python econometric stack — pandas + numpy + scipy + statsmodels + linearmodels + pyfixest +…
Use when the user asks to run a full empirical / causal analysis in Python — by default in the style of an applied economics paper (AER / QJE / JPE / ReStud /…
Classical end-to-end empirical analysis workflow in the traditional Python econometric stack — pandas + numpy + scipy + statsmodels + linearmodels + pyfixest +…
Classical end-to-end empirical analysis workflow in the traditional Stata ecosystem — native Stata + reghdfe + ivreg2 + csdid + did_imputation +…
Classical end-to-end empirical analysis workflow in the modern tidyverse + econometrics R ecosystem — dplyr + tidyr + haven + fixest + sandwich + lmtest +…
Systematic writing framework for philosophy and interdisciplinary academic papers from optimized outline to submission-ready manuscript. Use when users want…