Guide · Agent skill
How to use the Token Unlock & Treasury Analysis agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Token Unlock & Treasury Analysis skill (token-unlock-treasury) teaches an AI agent how to read crypto vesting schedules, estimate how much selling pressure an unlock might create, and judge whether a project's treasury looks healthy. It is aimed at traders, analysts, researchers and developers who want a structured method rather than gut feel. By the end of this guide you will know how to install the skill, how to phrase requests so the agent uses it, and what limits to keep in mind.
Token Unlock & Treasury AnalysisHKUDS/Vibe-Trading · MIT Download the skill Quick start
- 1Download the ZIP. Download the ZIP file from this page to your computer.
- 2Unzip the skill folder. Extract the token-unlock-treasury folder so that SKILL.md sits inside it.
- 3Place it in a skills folder. Move the folder to ~/.claude/skills/ for personal use or to .claude/skills/ in a project. Alternatively, upload it under Settings → Capabilities → Skills in the Claude apps.
- 4Gather your data. Collect the unlock amount, circulating supply, daily volume and recipient type, or the treasury figures, from a source you trust.
- 5Ask a plain question. Describe the unlock or treasury question in natural language, including your numbers.
- 6Check the reasoning. Ask the agent to show its assumptions and calculation, then verify the inputs against official project data.
What the skill makes the agent do
The skill is a single instruction file, SKILL.md, that gives the agent a framework for token distribution and unlock analysis. It describes standard allocation categories such as team, investor, ecosystem, treasury, public sale, airdrop and advisor tokens, with typical percentages, lock periods, vesting styles and sell-pressure risk for each.
It also covers three unlock types: cliff unlocks (one large release after a lock period), linear or continuous unlocks (steady releases over time), and milestone-based unlocks (triggered by protocol metrics). For treasury work it gives a checklist of runway, diversification, revenue coverage and red flags such as heavy reliance on the project's own token.
- Explain who receives tokens in a given unlock and how that group typically behaves
- Estimate an unlock's size as a percentage of circulating supply and as a multiple of daily trading volume
- Suggest likely short-term sell pressure, labelled as an estimate
- Assess treasury runway, diversification and revenue coverage
- Review token emission rates and whether they look sustainable
Install the skill from the ZIP
Download the ZIP file from this page. Unzip it so that the token-unlock-treasury folder, containing SKILL.md, ends up in one of two places: your personal skills folder at ~/.claude/skills/, or a project-specific folder at .claude/skills/ inside the project you are working in. Use the personal location if you want the skill available everywhere, and the project location if you want it only for that project.
If you use the Claude apps instead of a local setup, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/token-unlock-treasury/
- Project install: .claude/skills/token-unlock-treasury/ inside your project folder
- Claude apps: Settings → Capabilities → Skills
~/.claude/skills/token-unlock-treasury/SKILL.mdHow to trigger the skill with natural requests
You do not need a special command. Describe what you want in plain language and mention the topic, such as unlocks, vesting, cliffs, treasury or sell pressure. The agent uses the skill when the request matches its description.
Be specific about the numbers you have. The skill reasons from the figures you give it, so include the unlock amount, circulating supply, daily trading volume and recipient type when you have them.
- Explain the difference between a cliff unlock and a linear unlock for this token.
- If 40 million tokens unlock to seed investors, with 500 million circulating and 8 million daily volume, how much sell pressure might that create?
- Assess this project's treasury: 500 million USD total, 36 months of runway, 60% held in its own token.
- Compare the token distribution of these two projects and flag any concentration risk.
Use the built-in assessment functions
The SKILL.md file includes Python functions that the agent can follow or adapt. The main one, assess_unlock_impact, takes an unlock amount, circulating supply, daily volume and recipient type. It returns the unlock as a percentage of supply, the volume multiple, a base impact label (from negligible to critical), an adjusted sell-pressure figure and a volume absorption label.
Another example, treasury_signal, grades runway, native-token concentration and revenue coverage. Ask the agent to run the logic on your figures or to show you the calculation. Check the output against your own data before relying on it.
- assess_unlock_impact(unlock_amount, circulating_supply, daily_volume, recipient_type)
- treasury_signal(health) for runway, diversification and revenue signals
- emission_analysis(token) for monthly emission rates and real yield
def assess_unlock_impact(unlock_amount, circulating_supply, daily_volume, recipient_type)What you need before you start
The examples in the skill are written in Python, so you need Python available if you want to run or adapt them. The skill does not include any data source. You must supply live token unlock schedules and treasury figures yourself, from whatever source you trust.
The example numbers in the file, including the treasury and token figures, are illustrative. The historical percentage ranges are rough observations, and the file itself notes that market conditions vary widely.
- Python, if you want to run the example functions
- Your own current unlock schedules, supply, volume and treasury data
- No network access or script execution is required by the skill itself
Safety notes on scripts and network use
The skill does not run scripts and does not use the network. It is a set of instructions and reference code. Any calculations happen in the agent's own environment when you ask for them, and the skill does not fetch prices or unlock calendars.
Because the skill contains no live data, every answer depends on the figures you provide. Verify those figures with the project's official documentation or your data provider before acting on any output.
- Runs scripts: no
- Uses network: no
- Treat outputs as structured estimates, not financial advice or price predictions
Tips for better results
Give the agent complete inputs and state the recipient type. The impact calculation adjusts its sell-pressure estimate based on who receives the tokens, so 'team' and 'ecosystem' can lead to very different results. Ask for the reasoning as well as the label, so you can see which assumption is driving the answer.
When comparing projects, use the same inputs for each so the results are comparable. Remember that the skill's framework flags risks but does not predict outcomes.
- Always state the recipient type: team, investor_seed, investor_later, ecosystem, treasury, community
- Use the same time window and data source when comparing two projects
- Ask the agent to list its assumptions and the data it still needs
What people use it for
- Preparing for a known cliff unlock by estimating its size relative to supply and daily volume
- Comparing how much of each project's supply sits with teams, investors and ecosystem funds
- Screening several projects' treasuries for runway length and reliance on their own token
- Building a tokenomics dashboard that reuses the impact and treasury functions as a starting point
Frequently asked questions
How do I install the token-unlock-treasury skill?
Download the ZIP from this page and unzip it so the token-unlock-treasury folder with SKILL.md is in ~/.claude/skills/ for personal use or .claude/skills/ inside a project. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
What do I need to run this skill?
You need Python if you want to run the example functions. The skill includes no data feeds, so you must supply your own live unlock schedules and treasury figures.
Is the token-unlock-treasury skill free to use?
The source is listed under the MIT licence. Check the licence file in the repository for the full terms before redistributing or modifying it.
Does the skill run scripts or access the internet?
No. The skill is listed as not running scripts and not using the network. It only provides instructions and example Python functions, so it does not fetch live prices or unlock calendars.
Can this skill predict token prices?
No. The historical percentages are rough observations, the example numbers are illustrative, and the skill itself notes that market conditions vary widely. Use its outputs as structured estimates, not guaranteed predictions or financial advice.
What if the agent does not use the skill?
Make sure the folder is named token-unlock-treasury and contains SKILL.md directly inside it, then mention unlocks, vesting, cliffs or treasury explicitly in your request. If you installed it in a project, start the agent from that project folder.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits crypto traders, analysts and developers who want a consistent framework for thinking about token unlocks and treasury health, provided they bring their own verified data. It is a poor choice for anyone expecting live market information, guaranteed price forecasts or financial advice.
Download the skill