Help us improve
Share bugs, ideas, or general feedback.
From medsci-presentation
Adds a new journal to the MedSci Skills profile database. Extracts metadata from author guidelines and generates write-paper and find-journal profiles.
npx claudepluginhub aperivue/medsci-skills --plugin medsci-literatureHow this skill is triggered — by the user, by Claude, or both
Slash command
/medsci-presentation:add-journalinheritThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are helping a medical researcher add a new journal to the MedSci Skills profile database.
Recommends medical journals for manuscript submission using 2-pass matching against curated public and user-local private profiles, with scope fit rationale and AI disclosure policy.
Writes scientific manuscripts in paragraphs via two-stage outline-to-prose process. Applies IMRAD, APA/AMA/Vancouver citations, figures/tables, and reporting guidelines. For drafting research papers.
Provides LaTeX templates, formatting requirements, and submission guidelines for scientific journals, conferences, posters, and grant proposals.
Share bugs, ideas, or general feedback.
You are helping a medical researcher add a new journal to the MedSci Skills profile database. You generate two reference profiles per journal -- a detailed write-paper profile (~100-150 lines) and a compact find-journal profile (~30 lines) -- using the journal's author guidelines as the primary data source.
Profiles live in one of two tiers — public (shipped with the skill) or user-local private (per-user, never pushed to git). Pick the correct target in Phase 0 before any extraction.
${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/$HOME/.claude/private-journal-profiles/write-paper/$HOME/.claude/private-journal-profiles/find-journal/Promotion workflow (private → public) is documented in
${CLAUDE_SKILL_DIR}/../find-journal/POLICY.md.
public (shipped) or private (user-local only)If the user provides only a journal name without a URL, ask for the Author Guidelines URL before proceeding. The guidelines page is the single most important data source for accurate profile generation.
If the user does not state the target tier, ASK explicitly before proceeding. Use these defaults and criteria to guide the question:
private for any journal outside the user's stated area of deep
expertise. Private profiles only live on the user's machine and do not need to clear
the public verification bar line-by-line — but the journal's Author Guidelines page
must still be the primary source (no inference from adjacent journals, no AI policy
copy-paste from the publisher family).public is appropriate only when all of the following hold:
../find-journal/POLICY.md before commit.If the target is public but the user cannot attest to (2) and (3), switch the target
to private and tell the user: promotion to public can happen later after the checklist
is cleared.
Before any data extraction, check whether the journal already exists:
Glob all four directories (public + private across both skills):
${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/*.md
${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/*.md
$HOME/.claude/private-journal-profiles/write-paper/*.md
$HOME/.claude/private-journal-profiles/find-journal/*.md
Filename match: Normalize the journal name (spaces to underscores, remove special characters) and check for an exact filename match.
Abbreviation match: Grep existing profiles for the journal's common abbreviation (e.g., "JCO" for Journal of Clinical Oncology).
Extract the following. Mark any field that cannot be determined as [TODO: verify at journal site].
For write-paper profile:
| Field | Example |
|---|---|
| Full name | Journal of Clinical Oncology |
| Abbreviation | J Clin Oncol |
| Publisher | Wolters Kluwer (ASCO) |
| ISSN (print/online) | 0732-183X / 1527-7755 |
| Frequency | 36 issues/year |
| Impact Factor (with year) | ~45.3 (JCR 2023) |
| OA model | Hybrid |
| Acceptance rate | ~10-15% |
| Peer review type | Single-blind, 2-3 reviewers |
| Manuscript types with limits | Table: type, word limit, abstract, references, figures |
| Abstract format | Structured/unstructured, headings, word limit |
| Required sections | For Original Article |
| Statistical requirements | p-value format, CI, effect sizes |
| Figure specs | DPI, format, color, max count |
| Cover letter requirements | What to include |
For find-journal profile:
| Field | Example |
|---|---|
| Scope paragraph | 1-2 sentence scope description |
| Scope keywords | Comma-separated, 15-20 keywords |
| Article types | List of accepted types |
| Classification | Tier (Q1/Q2), OA, Field |
Present extracted metadata as a structured summary. Ask the user:
Do NOT proceed to Phase 3 until user confirms or provides corrections.
Read ONE existing write-paper profile from a similar field as a format reference:
| Field | Template to Load |
|---|---|
| Radiology | Radiology.md or European_Radiology.md |
| General medicine | The_BMJ.md or JAMA.md |
| Medical education | Medical_Education.md or BMC_Medical_Education.md |
| AI / digital health | npj_Digital_Medicine.md or JMIR.md |
| IR / interventional | CVIR.md or JVIR.md |
| Surgery | Annals_of_Internal_Medicine.md |
| Other | The_BMJ.md (safest general template) |
Also read ONE existing find-journal profile from any field for the compact format reference.
Follow the canonical 11-section order exactly:
# Journal Profile: {Full Name}
## Journal Identity
- **Full name**: {name}
- **Abbreviation**: {abbrev}
- **Publisher**: {publisher}
- **ISSN**: {print} (print), {online} (online)
- **Frequency**: {frequency}
- **Impact Factor**: ~{IF} (JCR {year})
- **Open Access**: {OA model}
- **Acceptance rate**: ~{rate}
- **Peer review**: {type}
## Manuscript Types and Word Limits
| Type | Body Word Limit | Abstract | References | Figures/Tables |
|------|----------------|----------|------------|----------------|
| Original Article | {limit} | {limit} | {limit} | {limit} |
| ... | ... | ... | ... | ... |
---
## Abstract Requirements
{Structured or unstructured. Show format as code block if structured.}
---
## Required Sections (Original Article)
1. **Introduction**
2. **Methods**
- {subsections}
3. **Results**
4. **Discussion**
5. **{Other required sections if any}**
---
## Statistical Reporting
- {p-value format}
- {CI requirements}
- {Effect size requirements}
- {Software identification requirement}
- {Journal-specific statistical requirements}
---
## Figures
- **Maximum**: {N figures/tables}
- **Resolution**: {DPI} minimum
- **Format**: {accepted formats}
- **Color**: {policy}
---
## Common Rejection Reasons
1. {reason}
2. {reason}
3. {reason}
4. {reason}
5. {reason}
---
## Cover Letter
Should include:
- {requirements}
---
## AI Writing Disclosure Policy
- **Requirement level:** {Required / Recommended / Not specified — follows ICMJE recommendations}
- **Permitted scope:** {Language editing only / All tasks / describe specific policy}
- **Disclosure location:** {Methods / Acknowledgments / Cover letter / Submission form}
- **AI-generated images:** {Banned / Must be declared / Not specified}
- **Policy URL:** {URL to journal's AI policy page, or author guidelines URL if no dedicated page}
<!-- Use WebFetch to check the journal's Author Guidelines for AI policy.
If no specific AI policy found, use ICMJE default:
- Requirement level: Not specified — follows ICMJE recommendations
- Permitted scope: Language editing only — per ICMJE 2025
- Disclosure location: Methods
- AI-generated images: Not specified
- Policy URL: [author guidelines URL] (no dedicated AI policy page)
Add [VERIFY] tag if uncertain about any field. -->
---
## Author Guidelines URL
{URL}
---
## Positioning
{When to submit here. When NOT to submit here.}
| Dimension | {This Journal} | {Competitor 1} | {Competitor 2} |
|-----------|---------------|----------------|----------------|
| Society | ... | ... | ... |
| Scope | ... | ... | ... |
| Impact factor | ... | ... | ... |
| Emphasis | ... | ... | ... |
Follow the canonical 5-section format exactly:
# {Full Name}
## Identity
- **Abbreviation:** {abbrev}
- **Publisher:** {publisher}
- **ISSN:** {print} / {online}
- **Homepage:** {URL}
- **Author guidelines:** {URL}
## Scope
{1-2 sentence scope description.}
## Scope Keywords
{comma-separated keywords, 15-20 terms}
## Article Types Accepted
- Original Article
- Review Article
- ...
## Classification
- **Tier:** {Q1/Q2}
- **Open Access:** {Full OA / Hybrid / Subscription}
- **Field:** {field}
## Special Notes
{2-3 sentences on positioning, unique aspects, society affiliation.} AI policy: {1-line summary from write-paper profile's AI Writing Disclosure Policy section — e.g., "language editing only, dual disclosure required, AI images banned." or "follows ICMJE — disclose AI use in Methods."}
Present BOTH complete draft profiles to the user. Ask:
Do NOT write files until user approves both profiles.
Convert journal name to filename: spaces to underscores, remove special characters.
Examples:
Journal_of_Clinical_Oncology.mdJACC.mdThe_Lancet_Oncology.mdJAMA_Network_Open.mdRoute to the directory pair chosen in Phase 0 (target = public or private).
If target = public:
Write the write-paper profile to:
${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/{filename}.md
Write the find-journal profile to:
${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/{filename}.md
If target = private:
Ensure the private directories exist (create if missing):
$HOME/.claude/private-journal-profiles/write-paper/$HOME/.claude/private-journal-profiles/find-journal/Write the write-paper profile to:
$HOME/.claude/private-journal-profiles/write-paper/{filename}.md
Write the find-journal profile to:
$HOME/.claude/private-journal-profiles/find-journal/{filename}.md
Do NOT write private profiles anywhere inside the medsci-skills git tree.
Skip this phase entirely when target = private — private profiles are not counted in
public-facing descriptions.
When target = public: the profile library uses runtime counting via Glob (no hard-coded
totals). Do not edit SKILL.md or README.md to update numeric counts.
Report to user:
public or private) and paths writtenpublic: "Run git add -A && git commit in the medsci-skills repo"private: "Files are local-only in your private profiles directory (outside this repo) — do not commit to the public repo"When the user wants to add multiple journals in one session:
This avoids updating counts N times for N journals.
[TODO: verify at journal site].Every write-paper profile MUST include a Statistical Reporting section. If the journal's author guidelines do not specify statistical requirements, use these defaults and note they should be verified:
The Positioning section should include a comparison table against 2-3 similar journals, covering: society affiliation, scope emphasis, impact factor range, and distinguishing features.
[TODO: verify at journal site].| Context | Skill | Interaction |
|---|---|---|
| After adding | find-journal | New profile immediately available for journal matching |
| After adding | write-paper | New profile available as target journal for manuscript formatting |
| Verification | search-lit | Can verify journal exists in PubMed/NLM catalog if needed |