journal-skills

Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal recommendation/matching, submission strategy, PubMed search, or similar-literature statistics.

53 stars

Best use case

journal-skills is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal recommendation/matching, submission strategy, PubMed search, or similar-literature statistics.

Teams using journal-skills should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/journal-skills/SKILL.md --create-dirs "https://raw.githubusercontent.com/aipoch/medical-research-skills/main/scientific-skills/Evidence Insight/journal-skills/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/journal-skills/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How journal-skills Compares

Feature / Agentjournal-skillsStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal recommendation/matching, submission strategy, PubMed search, or similar-literature statistics.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)

## When to Use

- You have a manuscript title/abstract and need a shortlist of suitable journals to submit to.
- You want evidence-based journal matching using **similar PubMed literature** and journal distribution statistics.
- You need to compare candidate journals by **scope fit**, **open access requirements**, and **review/publication timelines**.
- You must provide a clear **matching rationale** (why each journal fits) for internal review or co-author alignment.
- You are planning a **submission strategy** (primary target + backups) and want to highlight risks and alternatives.

## Key Features

- Topic- and abstract-driven journal recommendation workflow.
- PubMed-based similar literature search and **journal frequency distribution** compilation.
- Candidate journal screening using scope, policy constraints (e.g., OA), and practical considerations (e.g., review cycle).
- Structured recommendation output with rationale, risks, and backup options.
- Reusable CSV template for consistent reporting.

## Dependencies

- Python 3.9+ (recommended)
- PubMed E-utilities access (NCBI)
  - `EMAIL` required (per NCBI policy)
  - `API_KEY` optional (recommended for higher rate limits)

## Example Usage

### 1) Prepare inputs
Have the manuscript **title** and **abstract** ready.

### 2) Configure the script
Open `scripts/pubmed_journal_recommender.py` and set the `CONFIG` values:

- `EMAIL`: your email (required)
- `API_KEY`: your NCBI API key (optional)
- Output directory (if the script supports/requests it)

### 3) Run the recommender
```bash
python scripts/pubmed_journal_recommender.py
```

When prompted, paste the manuscript title and abstract. The script will query PubMed for similar records and produce journal statistics.

### 4) Produce a structured recommendation table
Use the template below to standardize the final output:

- Template: `assets/journal_recommendation_template.csv`

Fill it with:
- Candidate journals (from the script’s distribution + domain knowledge)
- Matching rationale (scope fit + audience + similarity evidence)
- Constraints (OA, policies)
- Practical notes (review cycle, risks)
- Primary target and backup options

### 5) Follow the checklist and formatting guidance
For recommended output formats, checklists, and key points, see:

- `references/guide.md`

## Implementation Details

### Workflow Overview
1. **Topic and Scope Definition**
   - Identify the research field, subfield, and intended readership.
   - Confirm journal type preferences and constraints (e.g., OA mandates).

2. **Similar Literature Analysis (PubMed)**
   - Use the manuscript title/abstract to retrieve similar PubMed records.
   - Aggregate results by **journal** to compute a distribution (e.g., counts per journal).
   - Prioritize journals that appear frequently among highly relevant records.

3. **Journal Screening**
   - Cross-check each candidate against:
     - Journal scope/aims
     - Policy requirements (OA, data availability, ethics)
     - Review/publication timelines (if available)
   - Remove journals that are out-of-scope or non-compliant.

4. **Recommendation Output**
   - Provide a ranked list with:
     - Fit rationale (topic alignment + similarity evidence)
     - Risks (scope mismatch, policy conflicts, timeline concerns)
     - Alternatives (backup journals)

### Key Parameters / Notes
- **NCBI `EMAIL`**: required to comply with NCBI E-utilities usage policy.
- **NCBI `API_KEY`**: optional but recommended to reduce throttling and improve throughput.
- **Output structuring**: use `assets/journal_recommendation_template.csv` to ensure consistent fields and downstream usability.

Related Skills

journal-recommender

53
from aipoch/medical-research-skills

Recommend academic journals based on manuscript topic, abstract, and impact factor expectations. Use when the user wants to find suitable journals for their research manuscript, especially when they provide a topic, abstract, and target Impact Factor.

journal-matchmaker

53
from aipoch/medical-research-skills

Analyzes academic paper abstracts to recommend optimal journals for submission, considering impact factors, scope alignment, and domain expertise.

journal-latest-issue

53
from aipoch/medical-research-skills

Retrieve the latest journal issue's table of contents and abstracts from URL/DOI/PMID/RSS/TOC sources, then generate Chinese key points locally (no external translation APIs) when a new issue needs quick review and archiving.

journal-impact-factor-trend

53
from aipoch/medical-research-skills

Show journal impact factor and quartile trends over 5 years.

journal-cover-prompter

53
from aipoch/medical-research-skills

Use when creating journal cover images, generating scientific artwork prompts, or designing graphical abstracts. Creates detailed prompts for AI image generators to produce publication-quality scientific visuals.

journal-club-presenter

53
from aipoch/medical-research-skills

Generate journal club slides with background, critique, and discussion.

target-journal-matcher

53
from aipoch/medical-research-skills

Matches your study to appropriate journals based on topic, design, and evidence strength. Use when deciding where to submit a manuscript, comparing journal options by impact factor vs scope fit vs method tolerance, or finding a realistic submission target after a rejection. Also triggers on "where should I submit this paper", "which journal is best for my study", "find journals for my manuscript", "is this a good fit for [journal]", or "I need a journal with IF around X".

skill-auditor

53
from aipoch/medical-research-skills

A comprehensive auditor for any agent skill — including Manus, OpenClaw/ClawHub, Claude, LobeHub, or custom SKILL.md-based skills. Use this skill whenever a user wants to evaluate, audit, review, score, or quality-check an agent skill before publishing, updating, or deploying. Covers two hard veto gates (structural redlines + research integrity redlines), static quality scoring across 25 criteria (ISO 25010 + OpenSSF + Agent), dynamic test input generation, multi-mode execution testing, multi-layer output evaluation with five specialized category rubrics (Evidence Insight / Protocol Design / Data Analysis / Academic Writing / Other), a Research Veto that applies to all four research categories, human eval viewer generation, actionable P0/P1/P2 optimization recommendations, and automatic skill improvement that outputs a polished, production-ready SKILL.md. Also use whenever a user says "audit my skill", "evaluate my skill", "improve my skill", or wants a corrected version after evaluation.

two-sample-mr-research-planner

53
from aipoch/medical-research-skills

Generates complete two-sample Mendelian randomization (MR) research designs from a user-provided research direction. Use when users want to design, plan, or build a study using two-sample MR to test causal relationships. Triggers:"design a two-sample MR study", "build a publishable MR paper", "test whether this biomarker causally affects this disease", "generate Lite/Standard/Advanced MR plans", "screen multiple exposures with MR", "bidirectional MR design", "causal inference using GWAS summary statistics", or "I want to study X and Y using MR". Always outputs four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.

research-proposal-generator

53
from aipoch/medical-research-skills

Generates a comprehensive research proposal design based on input literature, including hypothesis, mechanism verification, and budget. Use when the user wants to design a research project from a paper.

research-grants

53
from aipoch/medical-research-skills

Write competitive research proposals for NSF, NIH, DOE, DARPA, and Taiwan's NSTC when you need agency-compliant narratives, budgets, and review-criteria alignment for a specific solicitation/FOA/BAA.

protocol-standardization

53
from aipoch/medical-research-skills

Standardize fragmented experimental steps into reproducible protocol documents when you need method organization, lab SOP drafting, or cross-operator reproducibility; missing parameters must be explicitly marked as "To be supplemented/Not provided".