Agent skill

Token Unlock and Treasury Analysis

by HKUDS in HKUDS/Vibe-Trading

Analyzes token vesting and unlock schedules plus project treasury holdings to estimate sell pressure around cliff and linear releases.

MITAuto-check passedBusiness, Finance & HR

Install Token Unlock and Treasury Analysis

skills CLI
$ npx skills add HKUDS/Vibe-Trading --skill token-unlock-treasury -a claude-code

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

GitHub CLI
$ gh skill install HKUDS/Vibe-Trading token-unlock-treasury --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/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/token-unlock-treasury .claude/skills/token-unlock-treasury && 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
token-unlock-treasury
GitHub stars
35k
Token cost
~2.8k tokens
SKILL.md length
622 words
Files
1
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Analyzes token vesting and unlock schedules plus project treasury holdings to estimate sell pressure around cliff and linear releases.

  • Works in 7 steps: Token Distribution Taxonomy → Unlock Event Types → Unlock Impact Assessment → …
  • Checking an upcoming token unlock before buying or holding a token
  • SKILL.md covers Overview, Core Concepts, Output Format and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill tracks how a crypto token's supply is released and what the project still holds. It classifies standard allocation groups, namely team, seed and later-round investors, ecosystem, treasury, public sale and advisors, with typical shares, lock periods, vesting terms and relative sell-pressure risk for each.

It distinguishes cliff unlocks, linear unlocks and milestone-based unlocks, and sketches an `assess_unlock_impact` function that weighs an unlock's size against circulating supply, daily trading volume and who receives the tokens. A section on historical price behavior around unlocks gives ranges by unlock size, drawn from data the skill says covers 2021 to 2025. The excerpt stops partway through that table, before the treasury tracking material.

When your agent uses it

  • Checking an upcoming token unlock before buying or holding a token
  • Estimating sell pressure from a vesting cliff or a linear release
  • Assessing a project's treasury holdings and diversification
  • Comparing how team, investor and ecosystem allocations vest

Example prompts

  • “A cliff unlock for a team allocation is coming up next month. How big is the likely sell pressure?”
  • “Break down this token's allocation by category and tell me which unlocks carry the most risk.”
  • “Does a monthly linear unlock matter much when the token trades on low daily volume?”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Token Distribution Taxonomy
  2. Unlock Event Types
  3. Unlock Impact Assessment
  4. Historical Unlock Price Patterns
  5. Treasury Health Analysis
  6. Emission Rate Analysis
  7. Major Protocol Unlock Calendars

What it can do on your machine

Read from SKILL.md and the folder at commit 8e43007. 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

    No URLs in SKILL.md.

    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

Token Unlock and Treasury Analysis loads about 2.8k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 622 words of instructions outside code blocks.

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

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 HKUDS/Vibe-Trading at commit 8e43007, republished under its MIT licence (© HKUDS). 622 words, ~2,811 tokens.

Download SKILL.mdSave it as .claude/skills/token-unlock-treasury/SKILL.md (or your agent's skills folder).
name
token-unlock-treasury
description
Token unlock schedule analysis and project treasury tracking — vesting cliffs, linear unlocks, team/investor/ecosystem token releases, treasury diversification, and sell pressure forecasting.
category
crypto

Token Unlock & Treasury Analysis

Overview

Track token vesting schedules, upcoming unlock events, and project treasury holdings to forecast sell pressure and assess project sustainability. Token unlocks are one of the most predictable and high-impact supply-side events in crypto — large unlocks consistently create short-term selling pressure.

Core Concepts

1. Token Distribution Taxonomy

Standard allocation categories:

CategoryTypical %Lock PeriodVestingSell Pressure Risk
Team / Founders15-25%12-24 months cliff2-4 year linearHigh (sell to fund lifestyle / diversify)
Investors (Seed)5-15%6-12 months cliff1-2 year linearVery high (VC fund lifecycle: must return capital)
Investors (Series A+)10-20%6-12 months cliff1-2 year linearVery high
Ecosystem / Community20-40%VariableOngoing emissionsMedium (depends on incentive design)
Treasury / Foundation10-20%None (discretionary)DAO-governedLow-medium (depends on governance)
Public Sale / Airdrop5-15%NoneImmediately liquidInitial dump, then stabilizes
Advisors2-5%6-12 months cliff1-2 year linearMedium
2. Unlock Event Types

Cliff unlock:

  • Large one-time release after lock period expires
  • Most impactful: 5-30% of supply unlocking in a single event
  • Typical impact: -5% to -20% price decline in the 7 days around a cliff unlock

Linear / continuous unlock:

  • Steady stream of tokens released over time (daily/weekly/monthly)
  • Creates persistent but predictable sell pressure
  • Impact depends on rate relative to trading volume

Milestone-based unlock:

  • Triggered by protocol metrics (TVL target, user count, etc.)
  • Less predictable but usually positive signal (means protocol is growing)
3. Unlock Impact Assessment
python
def assess_unlock_impact(unlock_amount, circulating_supply, daily_volume, recipient_type):
    """
    Assess the market impact of an upcoming token unlock.
    """
    # Unlock as % of circulating supply
    supply_pct = unlock_amount / circulating_supply * 100

    # Unlock as multiple of daily volume
    volume_multiple = unlock_amount / daily_volume

    # Base impact score
    if supply_pct > 10:
        base_impact = "critical"      # >10% of supply = very high impact
    elif supply_pct > 5:
        base_impact = "high"
    elif supply_pct > 2:
        base_impact = "medium"
    elif supply_pct > 0.5:
        base_impact = "low"
    else:
        base_impact = "negligible"

    # Adjust for recipient type (who receives the tokens)
    recipient_multiplier = {
        "team": 0.7,         # Team sells ~70% within 6 months historically
        "investor_seed": 0.8, # VCs must return capital, sell aggressively
        "investor_later": 0.6,
        "ecosystem": 0.3,    # Ecosystem tokens often re-staked or used
        "treasury": 0.2,     # Treasury rarely dumps (governance constraints)
        "community": 0.5,    # Mixed behavior
    }

    effective_sell_pressure = supply_pct * recipient_multiplier.get(recipient_type, 0.5)

    # Volume absorption capacity
    if volume_multiple > 5:
        absorption = "illiquid"       # Market cannot absorb easily
    elif volume_multiple > 2:
        absorption = "difficult"
    elif volume_multiple > 0.5:
        absorption = "manageable"
    else:
        absorption = "easily_absorbed"

    return {
        "supply_impact_pct": supply_pct,
        "base_impact": base_impact,
        "effective_sell_pct": effective_sell_pressure,
        "volume_absorption": absorption,
    }
4. Historical Unlock Price Patterns

Empirical observations (2021-2025 data):

Unlock Size (% of circ.)Pre-unlock (7d)Post-unlock (7d)Post-unlock (30d)
>10%-8 to -15%-5 to -20%-10 to -30% (often no recovery)
5-10%-3 to -8%-3 to -10%Mixed (depends on market regime)
2-5%-1 to -5%-2 to -5%Usually recovers within 30d
<2%Minimal-1 to -3%Negligible long-term impact

Key patterns:

  1. Pre-unlock front-running: market starts selling 3-7 days before known unlock dates
  2. Post-unlock recovery: if broader market is bullish, 2-5% unlocks often fully recover within 2-4 weeks
  3. Continuous unlock drag: tokens with >5% monthly emission rate tend to underperform BTC by 10-20% annualized
  4. Cliff + bear market = disaster: large cliff unlocks during bear markets create cascading selling
Show full SKILL.md (263 more words)Show less
5. Treasury Health Analysis

Treasury assessment framework:

python
treasury_health = {
    "total_value_usd": 500_000_000,       # Total treasury value
    "runway_months": 36,                   # Treasury / monthly burn
    "diversification": {
        "native_token_pct": 60,            # % held in own token (risky)
        "stablecoins_pct": 25,             # USDC/USDT/DAI (safe)
        "eth_btc_pct": 10,                 # Blue-chip crypto
        "other_pct": 5,                    # Other assets
    },
    "monthly_burn_usd": 5_000_000,         # Operating expenses per month
    "revenue_coverage": 0.6,               # Revenue / burn ratio
}

def treasury_signal(health):
    # Runway assessment
    if health["runway_months"] < 12:
        runway_signal = "critical"         # Less than 1 year of funding
    elif health["runway_months"] < 24:
        runway_signal = "concerning"
    else:
        runway_signal = "healthy"

    # Diversification assessment
    native_pct = health["diversification"]["native_token_pct"]
    if native_pct > 80:
        diversity_signal = "concentrated_risk"  # Treasury value crashes with token price
    elif native_pct > 50:
        diversity_signal = "moderate_risk"
    else:
        diversity_signal = "diversified"        # Healthy treasury management

    # Revenue sustainability
    if health["revenue_coverage"] > 1.0:
        revenue_signal = "self_sustaining"      # Revenue covers all expenses
    elif health["revenue_coverage"] > 0.5:
        revenue_signal = "partially_funded"
    else:
        revenue_signal = "treasury_dependent"   # Fully reliant on treasury

    return runway_signal, diversity_signal, revenue_signal

Red flags in treasury management:

  1. Treasury >80% in native token → death spiral risk (token drops → treasury drops → must sell more)
  2. Runway < 12 months → protocol may cut development or do emergency token sale
  3. Large OTC sales by treasury → dilution signal (often sold at 20-30% discount)
  4. Treasury spending on non-core activities (acquisitions, marketing burns) → poor capital allocation
  5. No revenue or declining revenue → unsustainable token emissions subsidizing usage
6. Emission Rate Analysis
python
def emission_analysis(token):
    """Analyze ongoing token emission sustainability."""
    # Monthly emission rate
    monthly_new_tokens = token.monthly_unlock + token.staking_rewards + token.mining_rewards
    monthly_emission_pct = monthly_new_tokens / token.circulating_supply * 100

    # Inflation-adjusted real yield
    staking_yield_nominal = token.staking_apy
    inflation_rate = monthly_emission_pct * 12  # Annualized
    real_yield = staking_yield_nominal - inflation_rate

    # Assessment
    if monthly_emission_pct > 5:
        emission_verdict = "hyperinflation"    # Unsustainable
    elif monthly_emission_pct > 2:
        emission_verdict = "high_inflation"    # Significant dilution
    elif monthly_emission_pct > 0.5:
        emission_verdict = "moderate"          # Manageable
    else:
        emission_verdict = "low_emission"      # Minimal dilution

    if real_yield < 0:
        yield_verdict = "negative_real_yield"  # Staking rewards < inflation = value destruction
    else:
        yield_verdict = "positive_real_yield"

    return emission_verdict, yield_verdict, real_yield
7. Major Protocol Unlock Calendars

Tier 1 protocols to track:

ProtocolTokenKey Unlock EventsData Source
SolanaSOLFoundation + early investor unlocksToken Unlocks
AptosAPTMonthly investor/team unlocksToken Unlocks
ArbitrumARBMassive team + investor cliff (Mar 2025)Token Unlocks
SuiSUIInvestor and contributor unlocksToken Unlocks
CelestiaTIAInvestor cliff unlockToken Unlocks
StarknetSTRKLarge early investor vestingToken Unlocks
OptimismOPOngoing core contributor vestingToken Unlocks
dYdXDYDXTrading rewards + team vestingToken Unlocks

Data sources:

  • tokenunlocks.app — most comprehensive unlock calendar
  • messari.io/asset/{token}/profile — tokenomics breakdown
  • Protocol governance forums — treasury proposals and spending

Output Format

## Token Unlock & Treasury Analysis — [Protocol/Token]

### Tokenomics Overview
- **Total supply**: X,XXX,XXX,XXX
- **Circulating supply**: X,XXX,XXX,XXX (X% of total)
- **Fully diluted valuation (FDV)**: $X.XB
- **Market cap / FDV ratio**: X.X% (lower = more future dilution)

### Upcoming Unlocks (next 90 days)
| Date | Amount | % of Circ. | Recipient | Impact |
|------|--------|-----------|-----------|--------|
| YYYY-MM-DD | X,XXX,XXX | X.X% | Team | High |
| YYYY-MM-DD | X,XXX,XXX | X.X% | Investor | Medium |

### Emission Rate
- **Monthly new supply**: X.X% of circulating
- **Annualized inflation**: X.X%
- **Staking nominal yield**: X.X%
- **Real yield (yield - inflation)**: X.X%
- **Verdict**: [hyperinflation / high / moderate / low]

### Treasury Health
- **Total value**: $XXX M
- **Composition**: X% native token, X% stablecoins, X% ETH/BTC
- **Monthly burn**: $X.X M
- **Runway**: XX months
- **Revenue coverage**: X.X%
- **Diversification risk**: [concentrated / moderate / diversified]

### Sell Pressure Forecast
- **Next 30 days**: [X tokens unlocking → $X.XM at current price → X days of volume]
- **Next 90 days**: [summary]
- **Absorption capacity**: [easily / manageable / difficult / illiquid]

### Signal
- **Short-term (pre-unlock)**: [avoid / reduce / hold / accumulate]
- **Medium-term (post-unlock)**: [recovery expected / persistent pressure / unclear]
- **Long-term (tokenomics health)**: [sustainable / concerning / unsustainable]

Notes

  • Token unlock data requires external sources (tokenunlocks.app, protocol docs); not available via OKX API
  • Unlock dates can change if governance votes to modify vesting schedules
  • Market cap / FDV ratio < 30% means >70% of tokens are still locked — significant future dilution risk
  • Always compare unlock impact relative to daily trading volume, not just supply percentage
  • Some protocols have buyback / burn mechanisms that offset emissions — check net inflation, not gross
  • This framework is for research purposes only and does not constitute investment advice

© HKUDS, 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 agent/src/skills/token-unlock-treasury of HKUDS/Vibe-Trading.

Open the folder on GitHubat commit 8e43007

Compare with similar skills

Token Unlock and Treasury Analysis 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.

Token Unlock and Treasury Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Token Unlock and Treasury Analysis this skillHKUDS/Vibe-Trading35k—~2.8kAutomated safety check: PassMIT
Predexon Prediction Market DataBlockRunAI/ClawRouter6.6k—~4.7kAutomated safety check: PassMIT
Futu OpenAPI Market and Trading Assistantqusong0627/QuantMind1.7k—~3.3kAutomated safety check: NotesAGPL-3.0
Alpha Vantageagent-skills-hub/agent-skills-hub1122 repos~1.6kAutomated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Strategy Performance Reporttradesdontlie/tradingview-mcp6.8k2 repos~591Automated safety check: PassCustom licence

Similar skills

  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Queries Futu quotes, options, fundamentals and accounts and places orders through the Futu OpenAPI Python SDK, defaulting to simulated trading.

    1.7k GitHub stars~3.3k tokensUpdated today
    Business, Finance & HRAuto-check: notes
  • Alpha Vantage

    agent-skills-hub/agent-skills-hub

    Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API.

    112 GitHub starsUsed in 2 repos~1.6k tokens
    Business, Finance & HRAuto-check passed
  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Strategy Performance Report

    tradesdontlie/tradingview-mcp

    Builds a performance report for a backtested Pine Script strategy from TradingView data, covering metrics, trades, the equity curve and improvement ideas.

    6.8k GitHub starsUsed in 2 repos~591 tokens
    Business, Finance & HRAuto-check passed
  • A-Share Daily Review

    qusong0627/QuantMind

    Produces a post-market review report for the China A-share market from local QuantDB data, news sentiment and model signals, ending in a next-day direction call.

    1.7k GitHub stars~1.9k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from HKUDS/Vibe-Trading

All 89 skills in this repo
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • OKX Market Data

    HKUDS/Vibe-Trading

    Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.

    35k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • SEC EDGAR Filings Fetcher

    HKUDS/Vibe-Trading

    Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.

    35k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • A-Share ST Risk Screener

    HKUDS/Vibe-Trading

    Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.

    35k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.

    35k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.

    35k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Questions about Token Unlock and Treasury Analysis

What does Token Unlock and Treasury Analysis do?

Analyzes token vesting and unlock schedules plus project treasury holdings to estimate sell pressure around cliff and linear releases. The skill tracks how a crypto token's supply is released and what the project still holds. It classifies standard allocation groups, namely team, seed and later-round investors, ecosystem, treasury, public sale and advisors, with typical shares, lock periods, vesting terms and relative sell-pressure risk for each.

When should I use Token Unlock and Treasury Analysis?

Token Unlock and Treasury Analysis fits situations like: checking an upcoming token unlock before buying or holding a token; estimating sell pressure from a vesting cliff or a linear release; assessing a project's treasury holdings and diversification; comparing how team, investor and ecosystem allocations vest.

How do I install Token Unlock and Treasury Analysis in Claude Code?

Run `npx skills add HKUDS/Vibe-Trading --skill token-unlock-treasury -a claude-code`. Or copy the skill folder (agent/src/skills/token-unlock-treasury in HKUDS/Vibe-Trading) into .claude/skills/token-unlock-treasury in your project. Claude Code loads it when a task matches its description.

How do I install Token Unlock and Treasury Analysis in Codex?

Run `npx skills add HKUDS/Vibe-Trading --skill token-unlock-treasury -a codex`. Or copy the skill folder (agent/src/skills/token-unlock-treasury in HKUDS/Vibe-Trading) into .agents/skills/token-unlock-treasury in your project. Codex loads it when a task matches its description.

Can I use Token Unlock and Treasury Analysis 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 HKUDS/Vibe-Trading --skill token-unlock-treasury -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/token-unlock-treasury, .gemini/skills/token-unlock-treasury, .github/skills/token-unlock-treasury and .opencode/skills/token-unlock-treasury in your project.

What does Token Unlock and Treasury Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Token Unlock and Treasury Analysis is instructions for the agent only.

Does Token Unlock and Treasury Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Token Unlock and Treasury Analysis 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 Token Unlock and Treasury Analysis use?

Token Unlock and Treasury Analysis 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 Token Unlock and Treasury Analysis use?

About 2.8k tokens (SKILL.md is roughly 11k 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 Token Unlock and Treasury Analysis?

Skills that share tags, products or a category with Token Unlock and Treasury Analysis: Predexon Prediction Market Data (BlockRunAI/ClawRouter, 6.6k stars), Futu OpenAPI Market and Trading Assistant (qusong0627/QuantMind, 1.7k stars), Alpha Vantage (agent-skills-hub/agent-skills-hub, 112 stars) and Technical Analyst (tradermonty/claude-trading-skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Token Unlock and Treasury Analysis?

HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 35,163 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 10, 2026.

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