Agent skill

Altmetrics Guide

by wentorai in wentorai/research-plugins

Guide to altmetrics and research impact beyond traditional citations

MITAuto-check passedResearch & Science

Install Altmetrics Guide

skills CLI
$ npx skills add wentorai/research-plugins --skill altmetrics-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins altmetrics-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature/metadata/altmetrics-guide .claude/skills/altmetrics-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
altmetrics-guide
GitHub stars
298
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
529 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Guide to altmetrics and research impact beyond traditional citations

  • Works in 5 steps: Usage: Downloads, views, library holdings → Captures: Bookmarks, readers, watchers → Mentions: Blog posts, news articles,… → …
  • Tasks that involve Citation management
  • SKILL.md covers What Are Altmetrics?, Key Altmetric Providers and…, Querying the Altmetric.com API and Interpreting Altmetrics…, plus 2 more sections
  • Reaches api.altmetric.com

What it does

Altmetrics Guide is an agent skill from wentorai/research-plugins. Guide to altmetrics and research impact beyond traditional citations

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Citation management. It works with X (Twitter), Wikipedia and Reddit. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Citation management

Example prompts

  • “/altmetrics-guide”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Usage: Downloads, views, library holdings
  2. Captures: Bookmarks, readers, watchers
  3. Mentions: Blog posts, news articles, reviews, Wikipedia
  4. Social Media: Tweets, Facebook likes, Reddit activity
  5. Citations: Scopus, CrossRef, patent citations

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.altmetric.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Altmetrics Guide loads about 1.5k tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 529 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 529 words, ~1,474 tokens.

Download SKILL.mdSave it as .claude/skills/altmetrics-guide/SKILL.md (or your agent's skills folder).
name
altmetrics-guide
description
Guide to altmetrics and research impact beyond traditional citations

Altmetrics Guide

Understand and use alternative metrics (altmetrics) to measure the broader impact and reach of research outputs beyond traditional citation counts.

What Are Altmetrics?

Altmetrics capture the online attention and engagement that research receives across diverse platforms. Unlike citation-based metrics (which can take years to accumulate), altmetrics provide near-real-time signals of how research is being discussed, shared, and used.

Source CategoryExamplesWhat It Measures
Social mediaTwitter/X, Facebook, Reddit, WeiboPublic discussion and sharing
News & blogsMainstream media, science blogsMedia coverage and science communication
Policy documentsGovernment reports, clinical guidelinesPolicy relevance
Reference managersMendeley, Zotero readershipAcademic readership and interest
WikipediaArticle citationsEducational and encyclopedic use
Peer reviewPublons, post-publication reviewFormal and informal peer evaluation
PatentsPatent citationsCommercial and industrial relevance

Key Altmetric Providers and Scores

Altmetric.com Attention Score

The Altmetric Attention Score is a weighted composite of online mentions:

SourceWeightRationale
News outlets8Editorial curation, wide audience
Blog posts5Expert commentary
Wikipedia3Encyclopedic significance
Policy documents3Real-world impact
Twitter/X posts1Broad sharing but low barrier
Facebook posts0.25General public engagement
Reddit posts0.25Community discussion
Mendeley readers0 (separate)Tracked but not in score
PlumX Metrics (Elsevier)

PlumX organizes metrics into five categories:

  1. Usage: Downloads, views, library holdings
  2. Captures: Bookmarks, readers, watchers
  3. Mentions: Blog posts, news articles, reviews, Wikipedia
  4. Social Media: Tweets, Facebook likes, Reddit activity
  5. Citations: Scopus, CrossRef, patent citations
Dimensions Badge

Dimensions provides citation counts alongside altmetric-style attention data, integrating grants, patents, clinical trials, and policy documents.

Querying the Altmetric.com API

python
import requests

# Look up altmetrics by DOI
doi = "10.1038/s41586-021-03819-2"
response = requests.get(f"https://api.altmetric.com/v1/doi/{doi}")

if response.status_code == 200:
    data = response.json()
    print(f"Title: {data.get('title')}")
    print(f"Altmetric Score: {data.get('score')}")
    print(f"Twitter mentions: {data.get('cited_by_tweeters_count', 0)}")
    print(f"News mentions: {data.get('cited_by_msm_count', 0)}")
    print(f"Blog mentions: {data.get('cited_by_feeds_count', 0)}")
    print(f"Wikipedia mentions: {data.get('cited_by_wikipedia_count', 0)}")
    print(f"Mendeley readers: {data.get('readers', {}).get('mendeley', 0)}")
    print(f"Detail URL: {data.get('details_url')}")
else:
    print("No altmetric data found for this DOI")
Batch Queries
python
# Query multiple DOIs using the Altmetric Explorer API (requires subscription)
# Free API supports individual lookups by DOI, PubMed ID, or arXiv ID

# Look up by PubMed ID
pmid = "34234348"
response = requests.get(f"https://api.altmetric.com/v1/pmid/{pmid}")

# Look up by arXiv ID
arxiv_id = "2103.14030"
response = requests.get(f"https://api.altmetric.com/v1/arxiv/{arxiv_id}")

Interpreting Altmetrics Responsibly

What Altmetrics Tell You
  • Speed of dissemination: How quickly research is being noticed
  • Audience breadth: Whether attention comes from academics, media, public, or policymakers
  • Geographic reach: Where in the world the work is being discussed
  • Interdisciplinary interest: Engagement from unexpected fields
Show full SKILL.md (220 more words)Show less
What Altmetrics Do NOT Tell You
  • Quality: High attention does not equal high quality (controversial or flawed papers can go viral)
  • Field-normalized comparison: Raw scores are not comparable across disciplines
  • Gaming resistance: Social media metrics can be artificially inflated
  • Comprehensive coverage: Not all platforms and languages are tracked equally

Best Practices for Using Altmetrics

  1. Combine with traditional metrics: Use altmetrics alongside citation counts, h-index, and peer review to build a complete picture of impact.
  2. Context matters: A score of 50 might be exceptional in pure mathematics but ordinary in public health. Check the "Compared to outputs of the same age" percentile.
  3. Report responsibly: When including altmetrics in CVs or grant applications, explain what the numbers mean (e.g., "Top 5% of all research outputs tracked by Altmetric.com").
  4. Track over time: Set up alerts for your publications to monitor engagement trends.
  5. Explore the sources: Click through to see who is discussing your work and in what context. A single policy document mention may be more meaningful than 100 tweets.

Tools for Tracking Your Research Impact

ToolCostFeatures
Altmetric.com BookmarkletFreeOne-click altmetrics for any paper
ImpactStory / OurResearchFreeORCID-based open access and impact profiles
Google Scholar ProfileFreeCitation tracking, h-index, i10-index
PlumX DashboardInstitutionalComprehensive multi-source tracking
DimensionsFree tierCitations + grants + patents + clinical trials

© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/literature/metadata/altmetrics-guide of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Altmetrics Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Altmetrics Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Altmetrics Guide this skillwentorai/research-plugins2981 repos~1.5kAutomated safety check: PassMIT
Qiaomu Opencli Usagejoeseesun/qiaomu-opencli-skills993—~3kAutomated safety check: PassMIT
Pulsealirezarezvani/claude-skills28k—~3.8kAutomated safety check: PassMIT
Citation Fixerinbrainfun/inbrain1421 repos~1.5kAutomated safety check: PassCustom licence
Reference Generatordmccreary/ibook-skills105—~2.8kAutomated safety check: PassNone
Morning AIdavepoon/buildwithclaude3.6k—~405Automated safety check: PassMIT

Similar skills

  • Qiaomu Opencli Usage

    joeseesun/qiaomu-opencli-skills

    A skill your agent uses when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv).

    993 GitHub stars~3k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Pulse

    alirezarezvani/claude-skills

    Multi-source recency research skill that takes the pulse of any topic across Reddit, Hacker News, the open web, and optionally X/Twitter within a configurable recent window (default 30 days).

    28k GitHub stars~3.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Citation Fixer

    inbrainfun/inbrain

    Audit and fix citation formatting across brain pages. An agent skill from inbrainfun/inbrain.

    142 GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed
  • Reference Generator

    dmccreary/ibook-skills

    Generates 10 curated academic references per chapter, prioritizing Wikipedia plus credited textbook authors known for innovative explanations, with relevance descriptions, stored in chapter…

    105 GitHub stars~2.8k tokensUpdated today
    Research & ScienceAuto-check passed
  • Morning AI

    davepoon/buildwithclaude

    AI news tracking skill that monitors 80+ entities across 6 free sources (Reddit, HN, GitHub, HuggingFace, arXiv, X/Twitter).

    3.6k GitHub stars~405 tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Questions about Altmetrics Guide

What does Altmetrics Guide do?

Guide to altmetrics and research impact beyond traditional citations. Altmetrics Guide is an agent skill from wentorai/research-plugins.

When should I use Altmetrics Guide?

Altmetrics Guide fits situations like: tasks that involve Citation management.

How do I install Altmetrics Guide in Claude Code?

Run `npx skills add wentorai/research-plugins --skill altmetrics-guide -a claude-code`. Or copy the skill folder (skills/literature/metadata/altmetrics-guide in wentorai/research-plugins) into .claude/skills/altmetrics-guide in your project. Claude Code loads it when a task matches its description.

How do I install Altmetrics Guide in Codex?

Run `npx skills add wentorai/research-plugins --skill altmetrics-guide -a codex`. Or copy the skill folder (skills/literature/metadata/altmetrics-guide in wentorai/research-plugins) into .agents/skills/altmetrics-guide in your project. Codex loads it when a task matches its description.

Can I use Altmetrics Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill altmetrics-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/altmetrics-guide, .gemini/skills/altmetrics-guide, .github/skills/altmetrics-guide and .opencode/skills/altmetrics-guide in your project.

What does Altmetrics Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Altmetrics Guide is instructions for the agent only. Our summary lists: Python 3.

Does Altmetrics Guide access the network?

SKILL.md names 1 domain. In commands or code: api.altmetric.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Altmetrics Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Altmetrics Guide use?

Altmetrics Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Altmetrics Guide use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Altmetrics Guide?

Skills that share tags, products or a category with Altmetrics Guide: Qiaomu Opencli Usage (joeseesun/qiaomu-opencli-skills, 993 stars), Pulse (alirezarezvani/claude-skills, 28k stars), Citation Fixer (inbrainfun/inbrain, 142 stars) and Reference Generator (dmccreary/ibook-skills, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Altmetrics Guide?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.