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** |