/add-journal

name: add-journal
description: Use when a target journal has no profile yet. Reads the journal's author guidelines and writes a detailed /write-paper profile plus a compact /find-journal profile, public or user-local private, in the canonical format with quality gates.
metadata:
  triggers: "add journal, new journal, create journal profile, journal profile 추가"

Add Journal Skill

Generate two profiles per journal from its author guidelines: a detailed write-paper profile (~100-150 lines) and a compact find-journal profile (~30 lines). Write profile content in English; the library is shared.

Key Directories

Profiles live in one of two tiers. Pick the target in Phase 0, before any extraction.

• **Public** (shipped; must meet the verification bar in

`${CLAUDE_SKILL_DIR}/../find-journal/POLICY.md`):

• write-paper: `${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/`
• find-journal: `${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/`
• **User-local private** (per-user, never pushed to git):
• write-paper: `$HOME/.claude/private-journal-profiles/write-paper/`
• find-journal: `$HOME/.claude/private-journal-profiles/find-journal/`

POLICY.md also documents promotion from private to public.

---

Phase 0: Input Collection

• **Required:** full official journal name; target tier (`public` or `private`).
• **Strongly encouraged:** Author Guidelines URL. If the user gives only a name, ask for this URL

before proceeding; it is the primary data source.

• **Optional:** field focus (used in 3.1), tier estimate (Q1/Q2/Q3), ISSN.

This skill does not judge whether a journal is legitimate. For an unfamiliar publisher, check DOAJ membership (for open-access titles) and indexing before writing a profile, and tell the user.

Public vs. Private target selection

If the user does not state the target tier, ASK before proceeding.

• **Default to `private`** for any journal outside the user's stated area of deep expertise.

Private profiles need not clear the public bar line by line, but the journal's own Author Guidelines page must still be the primary source: no inference from adjacent journals, no AI policy copied from the publisher family.

• **`public` only when all of these hold:**

1. The user intends to contribute the profile upstream. 2. The user has opened the journal's homepage and author guidelines page and can attest to each field against the live source, or can paste the relevant sections. 3. AI policy wording is transcribed from the journal's or publisher's own policy page, not inferred from a sibling journal. 4. The user has completed or will complete the promotion checklist in `../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 say that promotion can happen later once the checklist is cleared.

---

Phase 1: Duplicate Check

Before any extraction:

1. Glob all four directories:

   ${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

2. Check for an exact filename match on the normalized name (4.1 rules). 3. Grep existing profiles for the journal's common abbreviation (e.g., "JCO").

If found, report the paths. If present in only one directory, offer to create only the missing counterpart; if in both, offer to update or abort. Do NOT proceed to Phase 2 without user direction.

---

Phase 2: Data Extraction

• **Path A (WebFetch available):** fetch the Author Guidelines URL and parse it. If the page is

login-gated, JavaScript-heavy, or sparse, fall back to Path B.

• **Path B:** ask the user to paste the Author Guidelines content (or key sections). Never fail

silently when a fetch fails.

Extraction Checklist

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

**For the write-paper profile:** full name; abbreviation; publisher; ISSN (print/online); frequency; Impact Factor with its JCR year; OA model; acceptance rate; peer-review type; manuscript types with word, abstract, reference and figure limits; abstract format (structured or not, headings, word limit); required sections for an Original Article; statistical requirements (p-value format, CI, effect sizes); figure specs (DPI, format, color, max count); cover letter requirements.

**For the find-journal profile:** a 1-2 sentence scope paragraph; 15-20 comma-separated scope keywords; accepted article types; classification (tier Q1/Q2, OA, field).

--- Gate 1: Metadata Confirmation ---

Present the extracted metadata as a structured summary. Ask:

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

If the user's information conflicts with the source, present the conflict and ask. Do NOT proceed to Phase 3 until the user confirms or corrects.

---

Phase 3: Profile Generation

3.1 Load Reference Template

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 | `JMIR_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 for the compact format.

3.2 Generate Write-Paper Profile

The detailed profile `/write-paper` loads when drafting for this journal. Read `${CLAUDE_SKILL_DIR}/references/write_paper_pro