How do I install the Ton skill?

Run npx skillmds@latest add hairyf/ton in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Ton skill do?

TON Blockchain — addresses, messages, TVM, cells, Blueprint, contracts, payments, API. It is listed under Integrations & APIs on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ton?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

hairyf (@hairyf) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ton by hairyf — Agent Skill

Name: Ton
Rating: 4.5 (4 reviews)
Author: hairyf

File contents

Skill is based on TON documentation (ton-org/docs), generated at 2026-02-09.

TON (The Open Network) is a decentralized blockchain with an Actor model (all entities are smart contracts), stack-based TVM, and cell-based serialization. This skill covers foundations, contract development with Blueprint, payments, and API access.

Core References

Topic	Description	Reference
Addresses	Internal/external addresses, workchains, account ID	core-addresses
Messages	Message types, StateInit, deploy, transactions	core-messages
Cells & serialization	Cells, BOC, builders and slices	core-cells-serialization
TVM	Stack, data types, gas, instructions, get methods	core-tvm
TVM exit codes	Compute/action phase codes, testing	core-tvm-exit-codes
Fees & status	Storage/compute/forward fees, account status (nonexist, uninit, active, frozen)	core-fees-status
TVM registers	c0–c7, c4/c5 durable, c7 environment	core-tvm-registers

Features

Development

Topic	Description	Reference
Blueprint	create-ton, Sandbox, project structure	features-blueprint
Contract development	First contract, storage, messages, get methods, Tolk	features-contract-development
Tolk language	Types, message handling, lazy loading, IDE	features-tolk
Contract upgrades	setCodePostponed, setData, delayed and hot upgrades	features-upgrades
Standard wallets	V4, V5, Highload, comparison, use cases	features-wallets
Standard tokens	Jettons, NFTs, transfer, mint, burn, discovery	features-tokens
Signing	Ed25519, wallet/gasless/server patterns, TypeScript	features-signing

Payments & API

Topic	Description	Reference
Payments	Toncoin, Jettons, finality, monitoring	features-payments
API	Liteservers, TON Center, TonAPI, dTON	features-api

Best Practices

Topic	Description	Reference
Security	Integers, replay, accept_message, gas, random, front-running	best-practices-security

---name: tondescription: TON Blockchain — addresses, messages, TVM, cells, Blueprint, contracts, payments, API.---> Skill is based on TON documentation (ton-org/docs), generated at 2026-02-09.TON (The Open Network) is a decentralized blockchain with an Actor model (all entities are smart contracts), stack-based TVM, and cell-based serialization. This skill covers foundations, contract development with Blueprint, payments, and API access.## Core References| Topic | Description | Reference ||-------|-------------|-----------|| Addresses | Internal/external addresses, workchains, account ID | [core-addresses](references/core-addresses.md) || Messages | Message types, StateInit, deploy, transactions | [core-messages](references/core-messages.md) || Cells & serialization | Cells, BOC, builders and slices | [core-cells-serialization](references/core-cells-serialization.md) || TVM | Stack, data types, gas, instructions, get methods | [core-tvm](references/core-tvm.md) || TVM exit codes | Compute/action phase codes, testing | [core-tvm-exit-codes](references/core-tvm-exit-codes.md) || Fees & status | Storage/compute/forward fees, account status (nonexist, uninit, active, frozen) | [core-fees-status](references/core-fees-status.md) || TVM registers | c0–c7, c4/c5 durable, c7 environment | [core-tvm-registers](references/core-tvm-registers.md) |## Features### Development| Topic | Description | Reference ||-------|-------------|-----------|| Blueprint | create-ton, Sandbox, project structure | [features-blueprint](references/features-blueprint.md) || Contract development | First contract, storage, messages, get methods, Tolk | [features-contract-development](references/features-contract-development.md) || Tolk language | Types, message handling, lazy loading, IDE | [features-tolk](references/features-tolk.md) || Contract upgrades | setCodePostponed, setData, delayed and hot upgrades | [features-upgrades](references/features-upgrades.md) || Standard wallets | V4, V5, Highload, comparison, use cases | [features-wallets](references/features-wallets.md) || Standard tokens | Jettons, NFTs, transfer, mint, burn, discovery | [features-tokens](references/features-tokens.md) || Signing | Ed25519, wallet/gasless/server patterns, TypeScript | [features-signing](references/features-signing.md) |### Payments & API| Topic | Description | Reference ||-------|-------------|-----------|| Payments | Toncoin, Jettons, finality, monitoring | [features-payments](references/features-payments.md) || API | Liteservers, TON Center, TonAPI, dTON | [features-api](references/features-api.md) |## Best Practices| Topic | Description | Reference ||-------|-------------|-----------|| Security | Integers, replay, accept_message, gas, random, front-running | [best-practices-security](references/best-practices-security.md) |

Frequently asked questions

Ton