sui-move

name	sui-move
description	Move smart contract development on Sui. Use when writing, reviewing, or debugging Move code, Move.toml configuration, or Sui object model patterns.

Move Development Skill

Write Move smart contracts on Sui. Follow these rules precisely. Move on Sui is not Aptos Move and is not Rust — do not apply patterns from those languages.

This skill routes to focused sub-skills. Load only the ones relevant to the current task.

---

Sub-skills

sui-move-setup — Package Setup, Building & Testing

Skill: sui-dev-tools:sui-move-setup Load when: creating a new Move package, configuring Move.toml, running sui move build or sui move test, writing tests, or unsure what patterns to avoid from other Move dialects. Covers: §1 Package Setup, §2 Building and Testing, §3 What Move on Sui is NOT.

sui-move-syntax — Language Syntax

Skill: sui-dev-tools:sui-move-syntax Load when: writing module declarations, imports, functions, enums, macros, or need guidance on visibility, mutability, method syntax, or comments. Covers: §1 Module Layout, §2 Mutability, §3 Visibility, §4 Method Syntax, §5 Enums, §6 Macros, §7 Comments.

sui-move-object — Object Model

Skill: sui-dev-tools:sui-move-object Load when: defining structs, choosing abilities (key/store/copy/drop), working with object ownership (transfer/share/freeze), naming conventions, or using dynamic fields. Covers: §1 Structs, §2 Object Abilities Cheat Sheet, §3 Dynamic Fields.

sui-move-patterns — Design Patterns

Skill: sui-dev-tools:sui-move-patterns Load when: emitting events, handling errors, implementing OTW or capability patterns, or designing composable/pure functions. Covers: §1 Events, §2 Error Handling, §3 One-Time Witness, §4 Capability Pattern, §5 Pure Functions.

sui-move-stdlib — Standard Library

Skill: sui-dev-tools:sui-move-stdlib Load when: working with strings, Coin/Balance, Option, addresses/IDs, vectors, or TxContext — the everyday Sui Move APIs. Covers: §1 Common Standard Library Patterns.

---

Routing guide

Task	Load
Creating a new Move project	sui-move-setup
Writing module code / functions	sui-move-syntax
Defining structs or objects	sui-move-object + sui-move-syntax
Using Coin, Balance, vectors, etc.	sui-move-stdlib
Emitting events or error handling	sui-move-patterns
Implementing access control (caps)	sui-move-patterns + sui-move-object
Writing or fixing tests	sui-move-setup
Full contract from scratch	all sub-skills
Code review	all sub-skills