tokenomist — Claude Code skill: what it does, how to install
This skill reads token unlocks, emissions, and allocation data. Use it when checking supply pressure or vesting events before a trade.
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a claude-codeWhat tokenomist does
tokenomist lets an agent inspect a token by symbol, name, or identifier. It can return a token overview, cliff events, daily emission figures, and allocation details. A query such as ARB is resolved to the service’s canonical token record before the related data is fetched.
The skill uses script mode with python3 and imports from exports.py. Available helpers cover token resolution, combined overviews, unlock events, daily emissions, and allocation summaries or raw allocation data. Date filters accept ISO 8601 values or Unix timestamps.
Requests require TOKENMIST_API_KEY. Authentication is sent through the x-api-key header, while network calls use core/http_client.py and the platform proxy path.
What it helps with
- check a token’s upcoming unlock events
- measure scheduled daily emissions
- inspect allocation buckets and locked amounts
- resolve a symbol to its token record
- request a token overview for a date range
Example prompts for the agent
- Check upcoming unlocks and token amounts for
ARB. - Resolve
ENA, then show its daily emission by date. - Break down
SUIallocations and identify locked categories.
How to install tokenomist
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a claude-code2Manually: put the files in place
~/.claude/skills/tokenomist/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tokenomist/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a codex2Manually: put the files in place
.agents/skills/tokenomist/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a cursor2Manually: put the files in place
.cursor/skills/tokenomist/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills tokenomist2Manually: put the files in place
.github/skills/tokenomist/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path tokenomistManually: put the files in place
.devin/skills/tokenomist/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tokenomist
How do I install tokenomist in Claude Code?
Run npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a claude-code, then check ~/.claude/skills/tokenomist/SKILL.md.
What does tokenomist do?
It retrieves token unlock events, cliff schedules, daily emissions, and allocation data through the Tokenomist API.
What does tokenomist need to run?
The environment must provide TOKENMIST_API_KEY. Script calls use python3 and the functions exported from exports.py.