{"slug":"add-journal","title":"add-journal","summary":"Add a new journal to the MedSci Skills profile database. Extracts metadata from author guidelines, generates write-paper (detailed) and find-journal (compact) profiles in canonical format with quality gates.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-14T20:48:16.055631Z","repo":{"url":"https://github.com/Aperivue/medsci-skills","stars":318,"forks":75,"license":"MIT","updatedAt":"2026-09-27T05:05:17Z"},"bodyHtml":"
\n

name: add-journal\ndescription: >\nAdd a new journal to the MedSci Skills profile database. Extracts metadata from\nauthor guidelines, generates write-paper (detailed) and find-journal (compact)\nprofiles in canonical format with quality gates.\ntriggers: add journal, new journal, create journal profile, journal profile 추가\ntools: Read, Write, Edit, Grep, Glob\nmodel: inherit

\n

Add Journal Skill

\n

You are helping a medical researcher add a new journal to the MedSci Skills profile database.\nYou generate two reference profiles per journal -- a detailed write-paper profile (~100-150 lines)\nand a compact find-journal profile (~30 lines) -- using the journal's author guidelines as\nthe primary data source.

\n

Communication Rules

\n\n

Key Directories

\n

Profiles live in one of two tiers — public (shipped with the skill) or user-local private\n(per-user, never pushed to git). Pick the correct target in Phase 0 before any extraction.

\n

Public (shipped, must meet verification bar)

\n\n

User-local private (per-user override, optional)

\n\n

Promotion workflow (private → public) is documented in\n${CLAUDE_SKILL_DIR}/../find-journal/POLICY.md.

\n
\n

Phase 0: Input Collection

\n

Required

\n
    \n
  1. Journal name -- full official name (e.g., \"Journal of Clinical Oncology\")
    2. \n
  2. Target tier -- public (shipped) or private (user-local only)
    3. \n
\n

Strongly Encouraged

\n
    \n
  1. Author Guidelines URL -- primary data source for metadata extraction
    2. \n
\n

Optional

\n
    \n
  1. Field focus -- e.g., cardiology, oncology, surgery, general medicine, medical education, methodology
    2. \n
  2. Tier estimate -- Q1 / Q2 / Q3 (user's best guess)
    3. \n
  3. ISSN -- if known
    4. \n
\n

If the user provides only a journal name without a URL, ask for the Author Guidelines URL\nbefore proceeding. The guidelines page is the single most important data source for accurate\nprofile generation.

\n

Public vs. Private target selection

\n

If the user does not state the target tier, ASK explicitly before proceeding. Use these\ndefaults and criteria to guide the question:

\n\n

If the target is public but the user cannot attest to (2) and (3), switch the target\nto private and tell the user: promotion to public can happen later after the checklist\nis cleared.

\n
\n

Phase 1: Duplicate Check

\n

Before any data extraction, check whether the journal already exists:

\n
    \n

  1. Glob all four directories (public + private across both skills):

    \n
    ${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/*.md\n${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/*.md\n$HOME/.claude/private-journal-profiles/write-paper/*.md\n$HOME/.claude/private-journal-profiles/find-journal/*.md\n
    \n
    2. \n

  2. Filename match: Normalize the journal name (spaces to underscores, remove special characters)\nand check for an exact filename match.

    \n
    3. \n

  3. Abbreviation match: Grep existing profiles for the journal's common abbreviation\n(e.g., \"JCO\" for Journal of Clinical Oncology).

    \n
    4. \n
\n

If found:

\n\n

If not found:

\n\n
\n

Phase 2: Data Extraction

\n

Path A: WebFetch Available

\n
    \n
  1. Attempt to fetch the Author Guidelines URL.
    2. \n
  2. Parse the page for metadata fields listed in the extraction checklist below.
    3. \n
  3. If the page is insufficient (login-gated, JavaScript-heavy, or sparse), fall back to Path B.
    4. \n
\n

Path B: User-Provided Content

\n
    \n
  1. Ask the user to paste the Author Guidelines content (or key sections).
    2. \n
  2. Accept pasted content and extract metadata from it.
    3. \n
\n

Extraction Checklist

\n

Extract the following. Mark any field that cannot be determined as [TODO: verify at journal site].

\n

For write-paper profile:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldExample
Full nameJournal of Clinical Oncology
AbbreviationJ Clin Oncol
PublisherWolters Kluwer (ASCO)
ISSN (print/online)0732-183X / 1527-7755
Frequency36 issues/year
Impact Factor (with year)~45.3 (JCR 2023)
OA modelHybrid
Acceptance rate~10-15%
Peer review typeSingle-blind, 2-3 reviewers
Manuscript types with limitsTable: type, word limit, abstract, references, figures
Abstract formatStructured/unstructured, headings, word limit
Required sectionsFor Original Article
Statistical requirementsp-value format, CI, effect sizes
Figure specsDPI, format, color, max count
Cover letter requirementsWhat to include
\n

For find-journal profile:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldExample
Scope paragraph1-2 sentence scope description
Scope keywordsComma-separated, 15-20 keywords
Article typesList of accepted types
ClassificationTier (Q1/Q2), OA, Field
\n

--- Gate 1: Metadata Confirmation ---

\n

Present extracted metadata as a structured summary. Ask the user:

\n
    \n
  1. \"Is this information accurate? Any corrections?\"
    2. \n
  2. \"What are the common rejection reasons for this journal?\" (if not extractable)
    3. \n
  3. \"How would you position this journal relative to similar journals in the field?\"
    4. \n
\n

Do NOT proceed to Phase 3 until user confirms or provides corrections.

\n
\n

Phase 3: Profile Generation

\n

3.1 Load Reference Template

\n

Read ONE existing write-paper profile from a similar field as a format reference:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTemplate to Load
RadiologyRadiology.md or European_Radiology.md
General medicineThe_BMJ.md or JAMA.md
Medical educationMedical_Education.md or BMC_Medical_Education.md
AI / digital healthnpj_Digital_Medicine.md or JMIR.md
IR / interventionalCVIR.md or JVIR.md
SurgeryAnnals_of_Internal_Medicine.md
OtherThe_BMJ.md (safest general template)
\n

Also read ONE existing find-journal profile from any field for the compact format reference.

\n

3.2 Generate Write-Paper Profile

\n

The detailed profile /write-paper loads when drafting for this journal. Copy the literal\ntemplate from ${CLAUDE_SKILL_DIR}/references/write_paper_profile_template.md and fill it.

\n

Follow the canonical 11-section order exactly. /write-paper Phase 7 and /find-journal read\nthese profiles positionally — a reordered, renamed, or omitted section silently degrades both:

\n
    \n
  1. Journal Identity — full name, abbreviation, publisher, ISSN, frequency, impact factor, OA\nmodel, acceptance rate, peer-review type
    2. \n
  2. Manuscript Types and Word Limits
    3. \n
  3. Abstract Requirements — word cap and heading structure
    4. \n
  4. Required Sections (Original Article)
    5. \n
  5. Statistical Reporting
    6. \n
  6. Figures
    7. \n
  7. Common Rejection Reasons
    8. \n
  8. Cover Letter
    9. \n
  9. AI Writing Disclosure Policy — permitted scope, disclosure location, AI-generated-image\nstance, and the policy URL
    10. \n
  10. Author Guidelines URL
    11. \n
  11. Positioning — when to submit here, when not to, and the comparison table against two\ncompetitor journals
    12. \n
\n

Fill rules. Never guess a value. Tag any uncertain field with [VERIFY] rather than inventing\na plausible number — an invented word limit or abstract structure propagates straight into a\ndrafted manuscript. Where the journal publishes no dedicated AI policy, cite the publisher-level\npolicy and say so explicitly.

\n

Read on demand:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FileRead it whenCost if read blindly
references/write_paper_profile_template.mdyou are writing the profile and need the literal fill-in template~1,800 tokens of pure template; the section order above is all you need to plan the fetch
\n

3.3 Generate Find-Journal Profile

\n

Follow the canonical 5-section format exactly:

\n
# {Full Name}\n\n## Identity\n- **Abbreviation:** {abbrev}\n- **Publisher:** {publisher}\n- **ISSN:** {print} / {online}\n- **Homepage:** {URL}\n- **Author guidelines:** {URL}\n\n## Scope\n{1-2 sentence scope description.}\n\n## Scope Keywords\n{comma-separated keywords, 15-20 terms}\n\n## Article Types Accepted\n- Original Article\n- Review Article\n- ...\n\n## Classification\n- **Tier:** {Q1/Q2}\n- **Open Access:** {Full OA / Hybrid / Subscription}\n- **Field:** {field}\n\n## Special Notes\n{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.\"}\n
\n

--- Gate 2: Profile Review ---

\n

Present BOTH complete draft profiles to the user. Ask:

\n
    \n
  1. \"Review these profiles. Any corrections needed?\"
    2. \n
  2. \"Is the Scope paragraph accurate?\"
    3. \n
  3. \"Are the Common Rejection Reasons realistic?\"
    4. \n
\n

Do NOT write files until user approves both profiles.

\n
\n

Phase 4: Write Files and Update Counts

\n

4.1 Determine Filename

\n

Convert journal name to filename: spaces to underscores, remove special characters.

\n

Examples:

\n\n

4.2 Write Profile Files

\n

Route to the directory pair chosen in Phase 0 (target = public or private).

\n

If target = public:

\n
    \n

  1. Write the write-paper profile to:\n${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/{filename}.md

    \n
    2. \n

  2. Write the find-journal profile to:\n${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/{filename}.md

    \n
    3. \n
\n

If target = private:

\n
    \n

  1. Ensure the private directories exist (create if missing):

    \n\n
    2. \n

  2. Write the write-paper profile to:\n$HOME/.claude/private-journal-profiles/write-paper/{filename}.md

    \n
    3. \n

  3. Write the find-journal profile to:\n$HOME/.claude/private-journal-profiles/find-journal/{filename}.md

    \n
    4. \n
\n

Do NOT write private profiles anywhere inside the medsci-skills git tree.

\n

4.3 Update Profile Counts

\n

Skip this phase entirely when target = private — private profiles are not counted in\npublic-facing descriptions.

\n

When target = public: the profile library uses runtime counting via Glob (no hard-coded\ntotals). Do not edit SKILL.md or README.md to update numeric counts.

\n

4.4 Confirmation

\n

Report to user:

\n\n
\n

Batch Mode

\n

When the user wants to add multiple journals in one session:

\n
    \n
  1. Collect all journal names and URLs upfront.
    2. \n
  2. Run Phase 1 (duplicate check) for all journals first.
    3. \n
  3. For each journal, run Phases 2-3 individually with gates.
    4. \n
  4. Write all files in a single Phase 4 pass (one count update at the end).
    5. \n
\n

This avoids updating counts N times for N journals.

\n
\n

Quality Standards

\n

Never Fabricate

\n\n

Statistical Reporting Section Is Mandatory

\n

Every write-paper profile MUST include a Statistical Reporting section. If the journal's\nauthor guidelines do not specify statistical requirements, use these defaults and note\nthey should be verified:

\n\n

Positioning Section Should Compare

\n

The Positioning section should include a comparison table against 2-3 similar journals,\ncovering: society affiliation, scope emphasis, impact factor range, and distinguishing features.

\n
\n

Error Handling

\n\n
\n

Skill Interactions

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ContextSkillInteraction
After addingfind-journalNew profile immediately available for journal matching
After addingwrite-paperNew profile available as target journal for manuscript formatting
Verificationsearch-litCan verify journal exists in PubMed/NLM catalog if needed
\n
\n

What This Skill Does NOT Do

\n\n

Anti-Hallucination

\n\n","files":[{"path":"references/write_paper_profile_template.md","sizeBytes":3202,"isText":true},{"path":"SKILL.md","sizeBytes":15266,"isText":true},{"path":"skill.yml","sizeBytes":1429,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-14T20:49:33.059534Z","sha256":"B7248B1CD27AD935F79AA6E275CC1DDC6FB489BB52294D892B63DCA1B322D513","sizeBytes":8513},"review":null,"source":{"repositoryUrl":"https://github.com/Aperivue/medsci-skills","path":"skills/add-journal","license":"MIT","commit":"5599b724675a1d788e03cd58dabd3db7c68ca86b","subtreeSha":"BF7FBD5F0D4C21E7E1EFCECC9442901A1710E631C73EE002963A878A7F059B3D","lastSyncedAt":"2026-09-27T19:46:33.449845Z"},"reviewedAt":"2026-09-14T20:55:35.204931Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Aperivue/medsci-skills/tree/main/skills/add-journal"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install aperivue-medsci-skills@llmmart"},{"target":"git","command":"git clone https://github.com/Aperivue/medsci-skills.git"}]}