Guide · Agent skill
How to use the On-Chain Crypto Analysis agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The onchain-analysis skill teaches an AI agent how to read public blockchain data and explain it. It covers active addresses, whale behaviour, DeFi total value locked (TVL), DEX liquidity and valuation ratios such as MVRV, NVT and SOPR. This guide explains what the skill does, how to install it, how to ask for it, and where its limits are, so you can use it knowing what it can and cannot do.
On-Chain Crypto AnalysisHKUDS/Vibe-Trading · MIT Download the skill Quick start
- 1Download the ZIP. Get the onchain-analysis ZIP from the directory page.
- 2Unzip into a skills folder. Place the onchain-analysis folder, with SKILL.md inside, in ~/.claude/skills/ for personal use or in .claude/skills/ within a project.
- 3Or upload in the Claude apps. Go to Settings, then Capabilities, then Skills, and upload the skill.
- 4Ask a metric question. Name the metric and asset in plain language, such as asking what MVRV above 3.5 means.
- 5Supply your own data. Paste the current figures you want interpreted, since the skill does not fetch live data.
What an agent skill is and what this one makes the agent do
An agent skill is a folder containing a SKILL.md file with instructions that an AI agent reads when a request matches the skill's description. It gives the agent a method and reference material, not live data access.
This skill's SKILL.md contains written guidance and thresholds for on-chain analysis. Once it is loaded, the agent can explain metrics such as active addresses, new addresses, transaction count, transfer value, whale tiers, large transfer thresholds, TVL, stablecoin liquidity, MVRV, NVT and SOPR, and suggest whether a reading is bullish or bearish according to the rules in the file.
- Network activity: active addresses, new addresses, transaction count, transfer value
- Whale tracking: whale tiers, exchange inflows and outflows, large transfers
- DeFi liquidity: TVL trends, DEX volume, liquidity depth, LP yield, impermanent loss, stablecoin flows
- Valuation: MVRV, NVT, SOPR, Puell Multiple, Stock-to-Flow, Reserve Risk, exchange balance
- A composite score that weights valuation, activity, capital flow and whale behaviour
Install the onchain-analysis skill
Download the ZIP for the skill from the directory page. Unzip it so that the onchain-analysis folder, containing SKILL.md, sits in one of the skill locations below. For a personal install use ~/.claude/skills/. For a single project, use a .claude/skills/ folder inside the project.
If you use the Claude apps, you can instead upload the skill under Settings, then Capabilities, then Skills.
- Personal install: ~/.claude/skills/onchain-analysis/SKILL.md
- Project install: .claude/skills/onchain-analysis/SKILL.md inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload the skill
~/.claude/skills/onchain-analysis/SKILL.mdHow to trigger the skill with natural requests
You do not need a special command. Ask in plain language about the topic the skill covers, and the agent uses it when the request matches its description. Naming the metric or the asset helps the agent apply the right section.
Ask for interpretation, not for live numbers. The skill tells the agent what a metric means and how the file classifies it. You need to supply current figures yourself, or use another tool that provides them.
- What does an MVRV above 3.5 mean for Bitcoin?
- Explain SOPR at 1.0 and whether it is a support or resistance signal in a bull market.
- Which whale behaviours are bullish and which are bearish?
- Walk me through the composite on-chain score and how the weights work.
- Draft a short market commentary on Ethereum using the on-chain framework. Here are the figures I have: [paste them]
Example: reading a set of figures
Suppose you give the agent a few numbers you have collected: rising active addresses, falling exchange balances and an MVRV of 1.4. The skill's framework would let the agent describe each reading against the thresholds in the file, note that MVRV of 1.4 sits in the 1.0 to 2.0 range it labels as reasonable, and combine the indicators into a qualitative view.
Treat the output as a structured explanation of the file's heuristics. It is not a forecast, and the agent should not present it as one.
What it needs and safety notes
The skill lists no requirements. It runs no scripts and makes no network requests. The file itself is text guidance, so it cannot fetch prices, wallet data or TVL figures on its own. Any live data you see has to come from you or from a separate tool.
The signals are generic heuristics with historical examples. The source states they are not guaranteed predictions and can be wrong in any market regime. The skill is not a substitute for a qualified professional on tax, legal or regulatory questions about crypto holdings.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Licence: MIT
Tips for getting useful answers
Ask the agent to show which threshold it used and which section of the framework applies. This makes the reasoning easy to check against SKILL.md.
Use the output format the file provides for reports. It is a markdown template headed On-Chain Analysis Report with an on-chain snapshot section, so you can ask for that structure directly.
- Give the asset, the metric and the date range of your data in the same message
- Ask for the bearish case as well as the bullish one
- Check any threshold against your own source before you publish or act on it
What people use it for
- Learning what active addresses, whale transfers or TVL mean before reading crypto news
- Checking how a valuation ratio such as MVRV, NVT or SOPR is defined and classified
- Drafting a market commentary that cites on-chain indicators, using figures you have verified
- Teaching a blockchain data analysis course with a consistent set of definitions and thresholds
Frequently asked questions
Is the onchain-analysis skill free to use?
The skill is released under the MIT licence, as stated in the directory listing. The skill itself lists no requirements and runs no scripts. You will still need an AI agent environment that supports skills.
How do I install the onchain-analysis agent skill?
Download the ZIP from the directory page and unzip the onchain-analysis folder into ~/.claude/skills/ or a project's .claude/skills/ folder. Alternatively, upload it in the Claude apps under Settings, then Capabilities, then Skills.
Does the skill give live crypto prices or wallet data?
No. The SKILL.md file contains written guidance and thresholds only. It makes no network requests and runs no scripts, so it cannot fetch live data.
Can I use it to decide when to buy or sell?
The source says the signals are generic heuristics with historical examples, not guaranteed predictions, and can be wrong in any market regime. Use it to understand the metrics, and combine it with your own research and professional advice.
How is this different from other on-chain analysis tools?
This skill is a set of instructions for an AI agent, not a dashboard or data feed. It explains metrics and their thresholds, while tools that provide live data are separate products. If you need real-time alerts or live charts, you will need a dedicated data service.
Does the skill cover taxes or legal questions about crypto?
No. The source excludes tax, legal and regulatory questions about crypto holdings, which need a qualified professional.
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
Use this skill if you want an AI agent to explain on-chain metrics such as MVRV, NVT, SOPR, whale activity and TVL, or to help draft commentary that references them. Pick something else if you need live data, real-time alerts or dependable trade signals, since this file contains only written heuristics and no data connection.
Download the skill