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