Skip to main content
skill CX Codex

sui-move — Claude Code skill: what it does, how to install

sui-move — a skill for Claude Code, Codex and Cursor that guides writing, reviewing and debugging Move smart contracts on Sui.

Apache-2.0 633 installs ★ 25 updated 2026-11-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MystenLabs/skills --skill sui-move -a claude-code
Open on GitHub

What sui-move does

The assistant loads reference files for core language fundamentals, events, and coin operations as needed. Rules enforce strict patterns such as using object::new(ctx) for UIDs and public_transfer for cross-module transfers.

The skill engages when writing structs with abilities, configuring init functions, publishing packages, or issuing fungible tokens. When available in the environment, the assistant queries the Sui documentation MCP server at https://sui.mcp.kapa.ai for up-to-date verification.

What it helps with

  • write a Sui Move smart contract
  • audit Move code for security issues
  • create a fungible token and event structures
  • publish or upgrade a package on Sui

Example prompts for the agent

  • Write a Sui Move smart contract for a fungible token
  • Review this Move code for object transfer errors
  • How do I destroy an object without drop in Sui Move?

How to install sui-move

1Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill sui-move -a claude-code

2Manually: put the files in place

~/.claude/skills/sui-move/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sui-move/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sui-move

How to install sui-move in Claude Code?

Run npx skills add MystenLabs/skills --skill sui-move -a claude-code followed by ~/.claude/skills/sui-move/SKILL.md.

What does sui-move do?

It assists developers in writing, reviewing, and debugging Sui Move smart contracts while enforcing resource safety rules and object model standards.

What is required to use sui-move?

A supported AI coding platform and access to the Sui documentation MCP server or official docs for reference.

Source text

SKILL.md · Apache-2.0
---
name: sui-move
description: >
  Sui Move smart contract development. Use when writing, reviewing, or debugging
  Move code on Sui. Covers Move abilities (key, store, copy, drop), TxContext,
  init functions, One-Time Witness, package publishing and upgrades, resource safety,
  events, and coins. Also use when the user asks about struct abilities, UID,
  how to destroy objects, or how to create a fungible token.

  For object model and ownership, see the `object-model` skill.
  For programmable transaction blocks, see the `ptbs` skill.
  For frontend dApp development, see the `frontend-apps` skill.
  For project setup and Move.toml, see the `sui-move-project` skill.
---

# Sui Move

> **MCP tool:** When available in your environment, also query the Sui documentation MCP server (`https://sui.mcp.kapa.ai`) for up-to-date answers. Use it for verification and for details not covered by these reference files.

> **Source constraint:** All information in this skill is sourced exclusively from [docs.sui.io](https://docs.sui.io) and [move-book.com](https://move-book.com). When extending or updating this skill, only pull from these sources. Do not use third-party blogs, tutorials, or unofficial documentation.

Move is Sui's smart contract language, designed around resource safety and an object-centric data model. This skill covers the core Move language: the type system, abilities, resource safety, events, and coins.

This skill routes to focused reference files. Load only the ones relevant to the current task.

---

## Reference files (this skill)

### move — Move Language Fundamentals
**Path:** `move.md`
**Load when:** writing Move code, working with abilities, TxContext, time/Clock, init functions, One-Time Witness, `internal::Permit<T>`, `type_name` deprecations, packages, modules, structs, resource safety, access control patterns, admin rotation, deny lists, security review, or advanced design patterns (ability dosing, phantom events, shared-object concurrency, receiver syntax, error attributes, `transfer::receive`, field privacy, macros).
**Covers:** the four abilities and common combinations, TxContext methods, Clock object, init functions, OTW pattern, `internal::Permit<T>` type-level authorization, `type_name` deprecations, packages and upgrades, modules, structs, resource safety and object destruction, a worked Greeting example, admin rotation (two-step transfer), regulated coins and deny lists, security review checklist, advanced design patterns (ability dosing, phantom-type events, event denormalization, shared-object `&` vs `&mut`, receiver-syntax ordering, `#[error]` constants, `transfer::receive` privacy, field privacy, macro gotchas).

### events-coins — Events and Coins
**Path:** `events-coins.md`
**Load when:** emitting events, subscribing to events offchain, creating fungible tokens, or working with coin operations (mint, burn, split, join).
**Covers:** event emission, event struct requirements, coin::create_currency, TreasuryCap, CoinMetadata, standard coin operations.

---

## Related skills (load from separate skill directories)

| Topic | Skill | Load when |
|-------|-------|-----------|
| Object model, ownership, dynamic fields, collections, Display, transfer patterns | `object-model/` | Designing data models, choosing ownership types, using dynamic fields or collections, setting up Object Display |
| Programmable transaction blocks, commands, owned-object version conflicts | `ptbs/` | Building PTBs, composing transactions, sponsored transactions, troubleshooting transaction errors |
| Frontend dApp development, dApp Kit, wallet connection | `frontend-apps/` | Building React/Vue frontends, wallet integration, querying onchain state from the browser |
| Project setup, Move.toml, dependencies, publishing | `sui-move-project/` | Creating a Move project, configuring Move.toml, resolving build errors, publishing packages |
| Move 2024 syntax, method syntax, macros | `modern-move-syntax/` | Using Move 2024 edition features like method syntax, vector literals, option/loop macros |
| Composable function design | `composable-move-functions/` | Designing functions for PTB composability, parameter ordering, return patterns |
| Unit testing conventions | `move-unit-testing/` | Writing Move unit tests, test patterns, expected_failure, cleanup |
| Naming conventions | `naming-conventions/` | Naming errors, constants, capabilities, events, getters, dynamic field keys |

---

## Routing guide

| Task | Load |
|------|------|
| Writing a Move struct with abilities | move |
| Using TxContext or the Clock object | move |
| Writing an init function or OTW | move |
| Using `type_name` functions | move |
| Proving module authority with `internal::Permit<T>` | move |
| Publishing or upgrading a package | move |
| Destroying an object without drop | move |
| Emitting or subscribing to events | events-coins |
| Creating a fungible token | move + events-coins |
| Designing an object data model | `object-model/` skill |
| Choosing shared vs owned objects | `object-model/` skill |
| Using dynamic fields or collections | `object-model/` skill |
| Setting up Object Display | `object-model/` skill |
| Building a PTB | `ptbs/` skill |
| Implementing sponsored transactions | `ptbs/` skill |
| Building a frontend | `frontend-apps/` skill |
| Setting up Move.toml | `sui-move-project/` skill |
| Writing a complete smart contract | move + events-coins + `object-model/` + `naming-conventions/` + `modern-move-syntax/` |
| Code review | move + events-coins + `composable-move-functions/` + `naming-conventions/` + `modern-move-syntax/` |
| Security review / access control audit | move + `object-model/` (patterns) + events-coins |
| Advanced design patterns / performance tuning | move |

---

## Rules

- Always use `object::new(ctx)` to create UIDs. There is no other way.
- Use `public_transfer` (not `transfer`) when the object has `store` and the call originates outside the defining module.
- Event structs must have `copy` and `drop` abilities.
- No `as` casts on numeric types. Use `from`/`into` or `try_from`/`try_into`.
- To destroy an object without `drop`, unpack the struct and call `object::delete(id)` on the UID.

## Common mistakes

- **Confusing `transfer` with `public_transfer`.** The non-public variant only works within the defining module. Calling it from another module is a compile error.
- **Forgetting to delete the UID.** When destroying an object, you must call `object::delete(id)` on the UID field.
- **Assuming `ctx.epoch_timestamp_ms()` is precise.** It returns the epoch start time. Use the Clock object (`0x6`) for real-time timestamps.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Similar skills

All skills for Programming languages →

From the same set30

The whole set →
naming-conventions The naming-conventions Claude Code skill sets naming rules for Move contracts on Sui. The agent uses it while creating or reviewing types, functions, and constants. CX Codex +1 621installs sui-move-project sui-move-project is a Claude Code skill for setting up Sui Move projects and fixing Move.toml, dependency, and build issues. It activates for project creation and legacy-format migrations. CX Codex +1 620installs sui-object-model The sui-object-model Claude Code skill covers Sui objects and helps answer questions about ownership, transfers, and data storage in Sui Move. It activates for choices between ownership types or storage patterns. CX Codex +1 617installs composable-move-functions composable-move-functions — a skill for Claude Code enforces conventions for Sui Move function signatures. It activates when designing public APIs, ordering parameters, and handling object returns for PTB composition. CX Codex +1 616installs move-unit-testing The move-unit-testing Claude Code skill guides unit testing for Move smart contracts on Sui. It activates when asked to write tests or add them to a Move module. CX Codex +1 615installs sui-build The sui-build Claude Code skill guides Move package builds with sui move build. The agent uses it for Move coding and questions about the build command. CX Codex +1 613installs modern-move-syntax modern-move-syntax — a skill for Claude Code that enforces Move 2024 edition syntax for Sui smart contracts. It replaces legacy module calls with method dot notation, loop macros, and clean literals. CX Codex +1 613installs accessing-data accessing-data — a skill for Claude Code that guides data fetching on Sui across gRPC, GraphQL RPC, Archival Store, Walrus, and sui-indexer-alt. Triggers on queries about balances, objects, and JSON-RPC migrations. CX Codex +1 491installs

Project sponsors

Companies that keep this analytics open