add-journal

Files (3)

• SKILL.md
• write_paper_profile_template.md · references/
• skill.yml

SKILL.md (first lines)

# 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` |

From Aperivue/medsci-skills, MIT.

More from Aperivue/medsci-skills