跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
数据与分析

add-journal

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.

Aperivue · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Aperivue/medsci-skills --skill add-journal

技能说明


name: add-journal description: > 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. triggers: add journal, new journal, create journal profile, journal profile 추가 tools: Read, Write, Edit, Grep, Glob model: inherit

Add Journal Skill

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.

Communication Rules

  • Communicate with the user in their preferred language.
  • Journal names, profile content, and URLs are always in English.
  • Medical terminology and field names are always in English.
  • Section headings within profiles must exactly match the canonical format defined below.

Key Directories

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.

Public (shipped, must meet verification bar)

  • 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 override, optional)

  • Write-paper: $HOME/.claude/private-journal-profiles/write-paper/
  • Find-journal: $HOME/.claude/private-journal-profiles/find-journal/

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


Phase 0: Input Collection

Required

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

Strongly Encouraged

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

Optional

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

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.

Public vs. Private target selection

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

  • Default to 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:
    1. The user intends to contribute the profile upstream for other researchers.
    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/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 tell the user: promotion to public can happen later after the checklist is cleared.


Phase 1: Duplicate Check

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

  1. 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
    
  2. Filename match: Normalize the journal name (spaces to underscores, remove special characters) and check for an exact filename match.

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

If found:

  • Report which directory/directories already have the profile, with file paths.
  • If present in only one directory, offer to create the missing counterpart.
  • If present in both, offer to update the existing profiles or abort.
  • Do NOT proceed to Phase 2 without user direction.

If not found:

  • Confirm to user: "No existing profile found. Proceeding with data extraction."

Phase 2: Data Extraction

Path A: WebFetch Available

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

Path B: User-Provided Content

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

Extraction Checklist

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

For write-paper profile:

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
阅读完整来源 ↗