Index of every page on this site: llms.txt
All skills
agents365-ai avatar

/journal-if

@0a1679d
Run it yourself

Use when looking up journal impact factors (JCR IF), checking a journal's impact factor by name, comparing IF across journals, or answering questions about "影响因子" / "impact factor" / "IF". Triggers on "impact factor", "journal IF", "影响因子", "JCR", "IF score", "journal rank", "which journal has higher IF", "what is the IF of". PROACTIVELY USE when user mentions journal prestige, publication venue quality, or manuscript submission target evaluation.

Use this Skill: https://skilld.dev/gh/agents365-ai/365-skills/journal-if

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈120 tokens for metadata: the name and description. ≈1.5k when used: this file. ≈5k more on demand in 1 file.

Description uses 5.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈463 characters, or 5.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Journal Impact Factor Lookup

Look up journal impact factors using a two-source cascade: bundled CSV cache (~200 common journals) → OpenAlex API (approximate 2-year IF for any journal).

Critical rule: Always use journal_if.py for lookups. Never guess impact factors — they change yearly and vary by edition.

Quick Reference

User wants... Tier Command
Look up IF of a journal read python3 journal_if.py lookup "Nature Medicine"
Search for a journal read python3 journal_if.py search "cancer immunology"
Process a list of journals read python3 journal_if.py batch journals.txt
Cache-only (no network) read python3 journal_if.py --offline lookup "Cell"
Inspect cache state read python3 journal_if.py cache status
Refresh upstream CSV write python3 journal_if.py cache update
Machine-readable CLI contract read python3 journal_if.py schema
Schema for one subcommand read python3 journal_if.py schema lookup

Output format

Stdout is a stable JSON envelope when the CLI is not attached to a terminal (piped or captured by an agent), and a human-readable view when run on a TTY. To force a format: --format json|table|human|auto. --json is a back-compat alias for --format json.

Envelope shape:

  • Success: { "ok": true, "data": {...}, "meta": { "schema_version", "cli_version", "latency_ms" } }
  • Partial success (batch): { "ok": "partial", "data": { "succeeded": [...], "failed": [...] }, "meta": {...} }
  • Error: { "ok": false, "error": { "code", "message", "retryable", ... }, "meta": {...} }

Exit codes

Code Meaning
0 success (including partial success)
1 runtime / upstream error
2 validation / bad input (missing file, bad flag)
3 not found (no journal matched)

Error codes (inside error.code)

Code Retryable Exit Meaning
not_found no 3 Lookup completed but no source matched
upstream_unavailable yes 1 OpenAlex API failed transiently; retry later or use --offline
file_not_found no 2 Input file path does not exist
validation_error no 2 Bad argument or flag combination
runtime_error yes 1 Unexpected internal error

Data Sources

  1. Bundled CSV — ~200 top journals across life sciences, medicine, chemistry, physics, and engineering. Curated from JCR data, shipped with the skill. Always available, instant.

  2. OpenAlex API — Free, open API that computes an approximate 2-year impact factor from citation counts. Covers virtually all academic journals. The number differs from the official JCR IF — it's a citation-rate metric computed from the same formula (citations in year Y to items published in Y-1 and Y-2, divided by citable items in those two years) but using OpenAlex's own article classification. Adequate for ranking and comparison; do not cite as "the JCR impact factor" in formal contexts.

When to use which

Scenario Source
Quick check of a major journal Bundled CSV (instant)
Niche or newer journal OpenAlex fallback (automatic)
Formal submission / grant Note: OpenAlex IF ≠ official JCR IF. Cite only as approximate.
Batch processing many journals CSV for cached ones, OpenAlex for misses
Offline / air-gapped --offline flag (bundled CSV only)

Workflow

Step 1: Detect Intent

Intent Action
"What's the IF of Nature?" lookup "Nature"
"Compare IF of Cell and Science" Run lookup twice, compare results
"Which immunology journals have IF > 20?" search "immunology" then filter
"Process this list of journals" batch journals.txt
"Is this a high-impact journal?" lookup then interpret IF in field context

Step 2: Execute

Run the appropriate journal_if.py command. The script handles:

  1. Local CSV lookup (instant, ~200 curated journals)
  2. OpenAlex API fallback (automatic, approximate 2-year IF)
  3. Fuzzy matching — catches minor name variations

Step 3: Present Results

  • Show the journal name, impact factor, and data year
  • Note the source (CSV cache vs OpenAlex approximate)
  • For search results: show a table with IF, year, and category

Understanding Impact Factor

IF Range Typical Tier Example
> 30 Elite (top 0.1%) Nature (64.8), Science (56.9), Cell (64.5)
20–30 Exceptional (top 1%) Cancer Cell (50.3), Immunity (32.4)
10–20 Excellent (top 5%) Nature Communications (16.6), Sci Adv (13.6)
5–10 Strong (top 15%) eLife (7.7), Cell Reports (8.8)
2–5 Solid PLOS ONE (3.7), Sci Rep (4.6)
< 2 Niche / new Many field-specific and new journals

Caveats:

  • IF varies dramatically by field — a top mathematics journal may have IF < 5 while a mid-tier oncology journal has IF > 10.
  • Always compare IF within the same field.
  • The IF data year matters; values shift annually.
  • OpenAlex approximate IF differs from official JCR IF; treat as a ranking metric, not a certified number.

Batch Processing

Create a text file with one journal name per line:

Nature Medicine
Journal of Biological Chemistry
Proceedings of the National Academy of Sciences

Then run:

python3 journal_if.py batch journals.txt

Troubleshooting

Issue Solution
"No data found" Try a shorter/alternative name; use search for fuzzy matching
OpenAlex returns 0 or None IF The journal may be too new (needs 2+ years of data); use --offline to check cache only
OpenAlex IF differs from JCR Expected — OpenAlex uses its own article classification. Use for ranking, not formal citation.
Cache download fails Check network; the bundled CSV still works offline
Wrong journal matched Use more specific name; the fuzzy matcher picks the closest substring match

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The journal-if skill provides impact factor lookups using a local database and the OpenAlex API. It includes a cache update mechanism that downloads data from the official vendor repository. The skill follows best practices for academic research tools and no security risks were identified.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

Signed by skilld at 0a1679d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 2 months ago
What it can do
Runs commands Reads files Edits files
author
Agents365-ai
category
Academic Research
version
1.0.0
All 6 allowed tools
BashReadWriteEditGlobGrep
Other metadata
created
2026-07-14
updated
2026-07-14
github
https://github.com/Agents365-ai/365-skills
homepage
https://github.com/Agents365-ai/365-skills
metadata
{
  "version": "1.0.0",
  "openclaw": {
    "requires": {
      "bins": [
        "python3"
      ]
    },
    "emoji": "📊",
    "homepage": "https://github.com/Agents365-ai/365-skills",
    "os": [
      "macos",
      "linux",
      "windows"
    ]
  }
}

README badge

README badge for agents365-ai/365-skills/journal-if