Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install brycewang-stanford-awesome-agent-skills-for-empirical-research-skills-25-hosungyou-diverga-skills-g1git clone https://github.com/brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research.gitcp Awesome-Agent-Skills-for-Empirical-Research/SKILL.MD ~/.claude/skills/brycewang-stanford-awesome-agent-skills-for-empirical-research-skills-25-hosungyou-diverga-skills-g1/SKILL.md---
name: g1
description: |
VS-Enhanced Journal Matcher with Journal Intelligence MCP — Real-time journal data pipeline
with checkpoint-based human decisions. Uses OpenAlex + Crossref APIs for live metrics.
Light VS applied: Avoids IF-centric recommendations + multi-dimensional matching strategy
Use when: selecting target journals, planning submissions, comparing publication options
Triggers: journal, submission, impact factor, academic journal, publication, submit
version: "12.0.1"
---
# Journal Matcher
**Agent ID**: 17
**Category**: E - Publication & Communication
**VS Level**: Light (Modal Awareness)
**Tier**: Core
**Icon**: 📝
**Version**: 10.0.0
## Overview
Identifies optimal target journals for research and develops submission strategies.
Comprehensively analyzes journal scope, impact, review timeline, OA policies, and more
using **real-time data from OpenAlex and Crossref APIs** via the Journal Intelligence MCP.
Applies **VS-Research methodology** (Light) to go beyond Impact Factor-centric recommendations,
presenting multi-dimensional matching strategies suited to research context and goals.
## MCP Prerequisites
This agent uses the **Journal Intelligence MCP** (journal-server.js) for real-time data.
| MCP Server | Tools Used | Required |
|------------|-----------|----------|
| **journal** | `journal_search_by_field`, `journal_metrics`, `journal_publication_trends`, `journal_editor_info`, `journal_compare`, `journal_special_issues` | Yes (6 tools) |
**Fallback**: If MCP unavailable, agent operates in knowledge-based mode using training data.
### MCP Integration
| Tool | When Used | Pipeline Stage |
|------|-----------|---------------|
| `journal_search_by_field` | Initial journal discovery | Stage 1 |
| `journal_metrics` | Detailed metrics for candidates | Stage 1-2 |
| `journal_publication_trends` | Trend analysis for top journals | Stage 3 |
| `journal_editor_info` | Reviewer suggestion support | Stage 3 |
| `journal_compare` | Side-by-side comparison table | Stage 3 |
| `journal_special_issues` | Special issue opportunities | Stage 3 |
### Natural Language Routing
| User Query | Tool(s) Called |
|-----------|---------------|
| "Find journals for educational technology research" | `journal_search_by_field(field="educational technology")` |
| "What's the h-index of Computers & Education?" | `journal_metrics(journal_name="Computers & Education")` |
| "Compare these 3 journals" | `journal_compare(journal_ids=[...])` |
| "Show publication trends for this journal" | `journal_publication_trends(journal_id=...)` |
| "Who publishes most in this journal?" | `journal_editor_info(journal_id=...)` |
| "Any special issues on AI in education?" | `journal_special_issues(field="AI in education", ...)` |
## Pipeline Flow
```
User request (research abstract + field)
│
▼
Stage 1: G1 analyzes research field/methodology
│
├── journal_search_by_field(field) ─┐
└── journal_metrics(candidates) ───┘ [parallel MCP calls]
│
▼
🟠 CP_JOURNAL_PRIORITIES [AskUserQuestion]
"연구 분야: {field}. 저널 선택 우선순위를 선택하세요"
[Impact Factor 우선] [출판 속도 우선] [OA 우선] [Scope Fit 우선] [균형 추천]
│
▼
Stage 2: Re-rank journals by user's priority
│
├── journal_compare(top_5) ──────────────┐
└── journal_publication_trends(top_3) ───┘ [parallel MCP calls]
│
▼
🟠 CP_JOURNAL_SELECTION [AskUserQuestion]
"추천 저널 (실시간 데이터):"
Table: IF, h-index, Scope Fit, Review Speed, OA
[1순위 저널 선택] [여러 저널 동시 투고 전략] [더 많은 저널 검색] [다른 분야로 재검색]
│
▼
Stage 3: Generate detailed strategy for selected journal(s)
│
├── journal_editor_info(selected) ──────┐
└── journal_special_issues(selected) ───┘ [parallel MCP calls]
│
▼
Output: Report + Cover letter template + Sequential submission plan
```
## Checkpoints
| Checkpoint | Level | When | Options |
|------------|-------|------|---------|
| CP_JOURNAL_PRIORITIES | 🟠 Recommended | After initial search, before ranking | Impact Factor / Speed / OA / Scope Fit / Balanced |
| CP_JOURNAL_SELECTION | 🟠 Recommended | After comparison, before strategy generation | Select journal / Multi-submit / More search / Re-search |
### CP_JOURNAL_PRIORITIES
```yaml
question: "연구 분야: {field}. 저널 선택 우선순위를 선택하세요 / Select your journal priority"
header: "Journal Priorities"
options:
- label: "Impact Factor 우선"
description: "높은 IF/h-index 저널 중심 추천"
- label: "출판 속도 우선"
description: "빠른 리뷰/출판 프로세스 중심"
- label: "OA 우선"
description: "오픈 액세스 저널 + 낮은 APC 중심"
- label: "Scope Fit 우선"
description: "연구 주제와의 적합도 최우선"
- label: "균형 추천"
description: "모든 기준을 균형 있게 고려"
```
### CP_JOURNAL_SELECTION
```yaml
question: "추천 저널 목록입니다. 어떻게 진행하시겠습니까? / Select your preferred journal strategy"
header: "Journal Selection"
options:
- label: "1순위 저널 선택"
description: "가장 적합한 저널 1개에 대한 상세 전략 생성"
- label: "여러 저널 동시 투고 전략"
description: "순차적 투고 계획 (1순위 → 2순위 → 3순위)"
- label: "더 많은 저널 검색"
description: "다른 조건으로 추가 검색"
- label: "다른 분야로 재검색"
description: "연구 분야를 변경하여 다시 검색"
```
## VS Modal Awareness (Light)
⚠️ **Modal Journal Matching**: The following are the most predictable approaches:
| Criterion | Modal Approach (T>0.8) | Multi-dimensional Approach (T<0.5) |
|-----------|------------------------|-----------------------------------|
| Ranking | "Recommend by highest IF" | Scope fit + Readership + IF integrated |
| Selection | "Top journal → downward" | Goal-optimized (Speed/Impact/OA) |
| Strategy | "Next tier on rejection" | Parallel strategy (Preprint + Submit) |
| Cost | "Minimize APC" | ROI analysis (Visibility vs. Cost) |
**Multi-dimensional Principle**: IF is just one indicator; select optimal journal for research goals
## When to Use
- When selecting journals for paper submission
- When comparing between journals
- When developing submission strategy (1st, 2nd, 3rd choice)
- When reviewing OA publication options
## Core Functions
1. **Scope Matching** (MCP-enhanced)
- Research topic and journal scope fit
- Recent publication trend analysis via `journal_publication_trends`
- Special Issue information via `journal_special_issues`
2. **Impact Analysis** (MCP-enhanced)
- h-index, cited_by_count, works_count via `journal_metrics`
- 2yr_mean_citedness (proxy for Impact Factor)
- Within-field ranking via `journal_search_by_field`
3. **Practical Information**
- Average review time (knowledge-based)
- Acceptance/rejection rate (knowledge-based)
- Publication cost (APC) via `journal_metrics`
4. **OA Policy** (MCP-enhanced)
- is_oa status via `journal_metrics`
- Homepage URL for policy lookup
- Preprint policy (knowledge-based)
5. **Submission Strategy** (MCP-enhanced)
- Sequential submission plan
- Cover letter points
- Reviewer suggestions via `journal_editor_info`
## Journal Tier Classification
| Tier | Characteristics | Examples (General) | Acceptance Rate |
|------|----------------|-------------------|-----------------|
| **Tier 1** | Top, multidisciplinary | Nature, Science, PNAS | <10% |
| **Tier 2** | Field top | Psychological Bulletin, RER | 10-20% |
| **Tier 3** | Field upper | JEP:LMC, C&E, BJET | 20-35% |
| **Tier 4** | Field mid-level | Field-specific journals | 35-50% |
| **Tier 5** | Emerging, regional | Newer, regional journals | >50% |
## Input Requirements
```yaml
Required:
- research_abstract: "Research summary"
- field: "Academic area"
Optional:
- priorities: "IF vs. Speed vs. OA"
- study_type: "Empirical/Theoretical/Review"
- constraints: "Time, cost"
```
## Output Format
```markdown
## Journal Matching Report
### Research Information
- Title: [Research title]
- Field: [Academic field]
- Study Type: [Empirical/Theoretical/Review/Meta-analysis]
- Analysis Date: [Date]
- Data Source: OpenAlex + Crossref (real-time)
---
### 1. Research Characteristics Analysis
| Item | Analysis |
|------|----------|
| Subject Area | [Specific topic] |
| Methodological Approach | [Quantitative/Qualitative/Mixed] |
| Contribution Type | Theoretical/Empirical/Methodological |
| Potential Impact | High/Medium/Low |
| Target Audience | [Target readers] |
---
### 2. Recommended Journals List
#### 🥇 1st Choice: [Journal Name]
| Item | Information |
|------|-------------|
| Publisher | [Publisher name] |
| h-index | [X] (OpenAlex) |
| 2yr Mean Citedness | [X.XX] (proxy for IF) |
| Cited By Count | [X,XXX] |
| Works Count | [X,XXX] |
| Scope Fit | ⭐⭐⭐⭐⭐ (5/5) |
| Average Review Time | [X] weeks (Initial → Decision) |
| Estimated Acceptance Rate | ~XX% |
| OA Status | [Yes/No] |
| APC | $X,XXX (if applicable) |
| Preprint Policy | Allowed/Not allowed |
**Fit Analysis**:
- ✅ Recent similar topic published: [Paper example]
- ✅ Methodology preference: [Methodology]
- ⚠️ Caution: [Considerations]
**Submission Strategy**:
- Cover letter emphasis: [Points]
- Suggested reviewers: [From journal_editor_info data]
- Exclude reviewers: [If applicable, with reason]
---
#### 🥈 2nd Choice: [Journal Name]
[Same format]
---
#### 🥉 3rd Choice: [Journal Name]
[Same format]
---
### 3. Journal Comparison Table (from journal_compare)
| Criterion | [Journal 1] | [Journal 2] | [Journal 3] |
|-----------|-------------|-------------|-------------|
| h-index | X | X | X |
| 2yr Mean Citedness | X.XX | X.XX | X.XX |
| Works Count | X,XXX | X,XXX | X,XXX |
| Scope Fit | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Review Speed | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| OA Status | Yes/No | Yes/No | Yes/No |
| APC | $X,XXX | $X,XXX | Free |
---
### 4. Publication Trends (from journal_publication_trends)
| Year | Works | Citations | OA |
|------|-------|-----------|-----|
| 2024 | XXX | X,XXX | XXX |
| 2023 | XXX | X,XXX | XXX |
| ... | ... | ... | ... |
---
### 5. Sequential Submission Plan
```
Submission Strategy Timeline
─────────────────────────────────────────────
1st Submission: [Journal 1] (Tier 2)
│
├── Accept → 🎉 Complete
│
└── Reject (Expected: ~3 months later)
│
▼
2nd Submission: [Journal 2] (Tier 3)
│
├── Accept → 🎉 Complete
│
└── Reject (Expected: ~6 months later)
│
▼
3rd Submission: [Journal 3] (Tier 3-4)
│
└── High acceptance probability
```
**Estimated Total Time**:
- Best case: 3-4 months (1st acceptance)
- Typical: 6-9 months (2nd acceptance)
- Worst case: 12+ months (3rd or beyond)
---
### 6. Cover Letter Template
```
Dear Editor,
We are pleased to submit our manuscript entitled "[Title]"
for consideration for publication in [Journal Name].
[Why this journal - 2-3 sentences]
This study aligns well with [Journal]'s scope in [Area] and
addresses [Topic] that would be of interest to your readership.
[Key contribution - 2-3 sentences]
Our research [Main contribution] by [Method]. We found that [Key finding].
[Significance - 1-2 sentences]
These findings have implications for [Implications].
We confirm that this manuscript has not been published
elsewhere and is not under consideration by another journal.
Suggested reviewers:
1. [Name], [Affiliation] - [Reason] (from journal_editor_info data)
2. [Name], [Affiliation] - [Reason]
Thank you for your consideration.
Sincerely,
[Corresponding Author]
```
---
### 7. Additional Considerations
#### Open Access Options
| Journal | OA Status | APC | Institutional Agreement |
|---------|-----------|-----|------------------------|
| [Journal 1] | [Yes/No] | $X,XXX | Check needed |
| [Journal 2] | [Yes/No] | $X,XXX | None |
| [Journal 3] | [Yes/No] | Free | N/A |
#### Preprint Strategy
- ✅ Recommended: [Journal] allows preprints
- Recommended server: [arXiv/SSRN/OSF Preprints]
- Timing: Just before or after submission
#### Special Issue Opportunities (from journal_special_issues)
- [Journal]: "[Topic]" (Recent themed publications found)
```
## Prompt Template
```
You are an academic publishing strategy expert with access to real-time journal data
via the Journal Intelligence MCP (OpenAlex + Crossref APIs).
Please recommend suitable journals for the following research:
[Research Abstract]: {abstract}
[Field]: {field}
[Priorities]: {priorities}
[Study Type]: {study_type}
Pipeline:
1. Call journal_search_by_field(field) for initial candidates
2. Call journal_metrics for top candidates (parallel)
3. Present CP_JOURNAL_PRIORITIES checkpoint
4. Re-rank by user's priority
5. Call journal_compare(top_5) + journal_publication_trends(top_3) (parallel)
6. Present CP_JOURNAL_SELECTION checkpoint
7. For selected journal(s):
- Call journal_editor_info for reviewer suggestions
- Call journal_special_issues for opportunities
8. Generate full report with cover letter template
```
## Field-Specific Major Journals (Examples)
### Educational Technology/EdTech
| Tier | Journal | IF |
|------|---------|-----|
| T2 | Computers & Education | ~12 |
| T2 | Internet & Higher Education | ~8 |
| T3 | British Journal of Educational Technology | ~6 |
| T3 | Educational Technology Research & Development | ~5 |
| T3 | Journal of Computer Assisted Learning | ~5 |
### Educational Psychology
| Tier | Journal | IF |
|------|---------|-----|
| T1 | Review of Educational Research | ~11 |
| T2 | Journal of Educational Psychology | ~5 |
| T3 | Learning and Instruction | ~5 |
| T3 | Contemporary Educational Psychology | ~5 |
### HRD/Organizational Psychology
| Tier | Journal | IF |
|------|---------|-----|
| T2 | Human Resource Development Quarterly | ~4 |
| T2 | Journal of Organizational Behavior | ~6 |
| T3 | Human Resource Development Review | ~5 |
| T3 | Human Resource Development International | ~3 |
## Related Agents
- **18-academic-communicator**: Abstract and summary writing
- **19-peer-review-strategist**: Review response
- **13-internal-consistency-checker**: Pre-submission check
## References
- **VS Engine v3.0**: `../../research-coordinator/core/vs-engine.md`
- **Dynamic T-Score**: `../../research-coordinator/core/t-score-dynamic.md`
- **Creativity Mechanisms**: `../../research-coordinator/references/creativity-mechanisms.md`
- **Project State v4.0**: `../../research-coordinator/core/project-state.md`
- **Pipeline Templates v4.0**: `../../research-coordinator/core/pipeline-templates.md`
- **Integration Hub v4.0**: `../../research-coordinator/core/integration-hub.md`
- **Guided Wizard v4.0**: `../../research-coordinator/core/guided-wizard.md`
- **Auto-Documentation v4.0**: `../../research-coordinator/core/auto-documentation.md`
- Journal Citation Reports (Clarivate)
- Scimago Journal & Country Rank
- DOAJ (Directory of Open Access Journals)
- Sherpa Romeo (OA policies)
- OpenAlex API: https://docs.openalex.org/
- Crossref API: https://api.crossref.org/