asta-skill

asta-skill is a skill for Codex from HK-hub/AgentSkills. It costs 45 tokens per session (3,112 once invoked), scanned B, a copy of asta-skill, MIT.

A routing guide for Asta, an academic search service built on the Semantic Scholar database of research papers, citations, and authors.

In plain words
What is it for?
Use it to search academic papers, follow citation links, find authors, and decide which Asta tool to call when the Asta service is configured.
Why use it?
It helps choose the right search or citation lookup and warns about setup problems and common mistakes.

Skill for Codex

Written for Codex: reads ~/.codex or $CODEX_HOME. Also seen: mentions Claude Code; mentions Codex; built for openclaw.

Good fit Use it to search academic papers, follow citation links, find authors, and decide which Asta tool to call when the Asta service is configured.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hk-hub/agentskills/asta-skill
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add HK-hub/AgentSkills --skill asta-skill
Clone the repo
git clone --depth 1 https://github.com/HK-hub/AgentSkills

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for asta-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/hk-hub/agentskills/asta-skill.svg)](https://agentmods.dev/skills/hk-hub/agentskills/asta-skill)
Your own site
<a href="https://agentmods.dev/skills/hk-hub/agentskills/asta-skill"><img src="https://agentmods.dev/badge/skills/hk-hub/agentskills/asta-skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,112 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.03112
Opus 5 $0.00023 $0.01556
Sonnet 5 $0.00009 $0.00622
Haiku 4.5 $0.00005 $0.00311

Measured 8d ago against content hash 6b86a0650ad3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade B, and why

asta-skill scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- Codex CLI: add `[mcp_servers.asta] url = "https://asta-tools.allen.ai/mcp/v1"` and `env_http_headers = { "x-api-key" = "ASTA_API_KEY" }` to `~/.codex/config.toml`.
Origin

This is a copy

100% identical to asta-skill — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

asta-skill/SKILL.md · 133 lines

How it starts

The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Asta is Ai2's Scientific Corpus Tool, exposing the Semantic Scholar academic graph over MCP (streamable HTTP transport). This skill tells agents which Asta tool to call for which intent, and how to compose them into useful workflows.

Prerequisite Check

Before invoking any tool, verify the Asta MCP server is registered in the host agent. Tool names will be prefixed by the MCP server name chosen at install time (commonly asta__<tool> or mcp__asta__<tool>).

If no Asta tools are visible, do not make raw HTTP calls or invent results. Tell the user to register https://asta-tools.allen.ai/mcp/v1 as a streamable HTTP MCP server with an x-api-key header, then restart/reload the host. Minimal setup hints:

  • Codex CLI: add [mcp_servers.asta] url = "https://asta-tools.allen.ai/mcp/v1" and env_http_headers = { "x-api-key" = "ASTA_API_KEY" } to ~/.codex/config.toml.
  • Claude Code: run claude mcp add -t http -s user asta https://asta-tools.allen.ai/mcp/v1 -H "x-api-key: $ASTA_API_KEY".
  • Generic MCP clients: configure server URL https://asta-tools.allen.ai/mcp/v1 with header { "x-api-key": "<YOUR_API_KEY>" }.

Tool Map — Intent → Asta Tool

User intent Asta tool Notes
Broad topic search search_papers_by_relevance Supports venue + date filters
Known paper title search_paper_by_title Optional venues + publication_date_range filters
Known DOI / arXiv / PMID / CorpusId / MAG / ACL / SHA / URL get_paper Single-paper lookup
Multiple known IDs at once get_paper_batch Batch lookup — pass ids as a JSON array (not a comma-separated string, unlike snippet_search's paper_ids); prefer over N sequential get_paper calls; unresolvable IDs are silently dropped (no null/error), so reconcile returned paperIds against your input
Who cited paper X get_citations Forward citations, paginated; accepts publication_date_range but not venues; limit defaults to 100
Find author by name search_authors_by_name Default fields="name" returns only name + authorIdexplicitly request affiliations,paperCount,citationCount,hIndex,externalIds to get anything rankable; externalIds carries ORCID/DBLP (url/homepage are also selectable)
An author's publications get_author_papers Pass author id; field param is paper_fields (not fields); limit defaults to 1000 — set it explicitly
Find passages mentioning X snippet_search ~500-word excerpts (title/abstract/body, excludes captions & bibliography); see snippet-specific params below

Read the full file on GitHub · 133 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 133 lines · 45 tokens per session scan B 6b86a0650ad3

Subscribe to this mod's changes

asta-skill is a skill published in the GitHub repository HK-hub/AgentSkills (6 stars, last pushed 21d ago), licensed MIT. It adds 45 tokens to every session and 3,112 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). It is 100% identical to asta-skill, differing in 0 lines, and is treated as a copy.