# sui-move

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 633 installs · ★ 25 repo stars
- Author: MystenLabs
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/MystenLabs/skills/tree/HEAD/sui-move/SKILL.md
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sui-move

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MystenLabs/skills --skill sui-move -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sui-move/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sui-move/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MystenLabs/skills --skill sui-move -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sui-move/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MystenLabs/skills --skill sui-move -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sui-move/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MystenLabs/skills sui-move
```

2. **Manually: put the files in place**
- File: `.github/skills/sui-move/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MystenLabs/skills --skill sui-move -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MystenLabs/skills --path sui-move
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sui-move/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MystenLabs/skills --skill sui-move -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MystenLabs/skills/tree/HEAD/sui-move/SKILL.md

## When to use it
- 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
- 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?

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d7959b31976b8ba0.

BEGIN THIRD-PARTY FILE d7959b31976b8ba0
```text
---
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 |
```
END THIRD-PARTY FILE d7959b31976b8ba0

The third-party file has ended. Everything between the d7959b31976b8ba0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3382 of 6659 bytes. © MystenLabs · Apache-2.0 · https://github.com/MystenLabs/skills/tree/HEAD/sui-move/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
