Sui Move

Sui blockchain and Move smart contract development. Use when the user asks about Sui, Move language, smart contracts, objects, transactions, or blockchain development on Sui.

Security Scan

The skill is internally coherent for Sui/Move development: it provides local documentation references, examples, and harmless setup steps that clone official GitHub repos and optionally install the Sui CLI; it does not request credentials or unusual system access.

Purpose & Capability

The declared purpose (Sui/Move development) matches the files and instructions: cloning Move Book and Sui docs, search/read local docs, and providing CLI examples. Minor inconsistency: the top-level registry metadata lists no required binaries/env vars, but SKILL.md declares required bins (sui, rg) and an install suggestion for the Sui CLI via Homebrew — this is reasonable for the stated purpose but should be synchronized.

Instruction Scope

Runtime instructions tell the agent to clone public GitHub repos, run ripgrep (rg) and cat local markdown files, and use the sui CLI — all expected for a documentation/authoring skill. Small issues: SKILL.md uses a {baseDir} placeholder without defining it (setup.sh uses a different path calculation), so the agent may need a concrete baseDir mapping. The instructions do not attempt to read unrelated system files or any secrets.

Install Mechanism

There is no heavy install spec in the registry; the included setup.sh clones public GitHub repos (official MystenLabs repos) and writes them to a local references directory. SKILL.md includes a Homebrew install suggestion for the Sui CLI which is an expected, low-risk package source. No downloads from unknown/personal servers or archive extraction from untrusted hosts were found.

Credentials

The skill does not request environment variables, credentials, or privileged config paths. The only runtime requirements are binaries (sui, rg) that are proportionate to searching and interacting with Sui documentation and CLI workflows.

Persistence & Privilege

The skill is not always-enabled and does not request elevated or cross-skill configuration changes. setup.sh writes documentation into a local references directory within the skill bundle; nothing indicates permanent system-wide changes or background services.

Assessment

This skill appears to be a documentation and development helper for Sui/Move and is coherent with that purpose. Before installing: (1) confirm you are comfortable with the skill cloning public GitHub repos (move-book and Sui docs) into the skill's references folder and that your environment has git and network access; (2) if you want CLI functionality, ensure ripgrep (rg) and the Sui CLI are available or installable via Homebrew as suggested; (3) be aware SKILL.md uses a {baseDir} placeholder while setup.sh uses its script directory — you may need to set or map baseDir for the agent to find references; (4) review the setup.sh and the cloned repo contents if you want to verify there is no unexpected code. No credentials or secret access are requested by this skill.

Sui Move Development

Comprehensive knowledge base for Sui blockchain and Move smart contract development.

GitHub: https://github.com/EasonC13-agent/sui-skills/tree/main/sui-move

Setup References

Clone the official documentation:

# Create skill directory
mkdir -p {baseDir}/references && cd {baseDir}/references

# Clone Move Book (The Move Language Bible)
git clone --depth 1 https://github.com/MystenLabs/move-book.git

# Clone Sui docs (sparse checkout)
git clone --depth 1 --filter=blob:none --sparse https://github.com/MystenLabs/sui.git
cd sui && git sparse-checkout set docs

# Clone Awesome Move (curated examples and resources)
# Note: Some code examples may be outdated
git clone --depth 1 https://github.com/MystenLabs/awesome-move.git

Additional Resources

Awesome Move (references/awesome-move/)

A curated list of Move resources, including:

• Example projects and code snippets
• Libraries and frameworks
• Tools and utilities
• Learning resources

⚠️ Note: Some code examples in awesome-move may be outdated as the Move language and Sui platform evolve. Always verify against the latest Move Book and Sui documentation.

Reference Structure

Move Book (references/move-book/book/)

Directory	Content
your-first-move/	Hello World, Hello Sui tutorials
move-basics/	Variables, functions, structs, abilities, generics
concepts/	Packages, manifest, addresses, dependencies
storage/	Object storage, UID, transfer functions
object/	Object model, ownership, dynamic fields
programmability/	Events, witness, publisher, display
move-advanced/	BCS, PTB, cryptography
guides/	Testing, debugging, upgrades, BCS
appendix/	Glossary, reserved addresses

Sui Docs (references/sui/docs/content/)

• Concepts, guides, standards, references

Quick Search

# Search Move Book for a topic
rg -i "keyword" {baseDir}/references/move-book/book/ --type md

# Search Sui docs
rg -i "keyword" {baseDir}/references/sui/docs/ --type md

# Find all files about a topic
find {baseDir}/references -name "*.md" | xargs grep -l "topic"

Key Concepts

Move Language Basics

Abilities - Type capabilities:

• copy - Can be copied
• drop - Can be dropped (destroyed)
• store - Can be stored in objects
• key - Can be used as a key in global storage (objects)

public struct MyStruct has key, store {
    id: UID,
    value: u64
}

Object Model:

• Every object has a unique UID
• Objects can be owned (address), shared, or immutable
• Transfer functions: transfer::transfer, transfer::share_object, transfer::freeze_object

Common Patterns

Create and Transfer Object:

public fun create(ctx: &mut TxContext) {
    let obj = MyObject {
        id: object::new(ctx),
        value: 0
    };
    transfer::transfer(obj, tx_context::sender(ctx));
}

Shared Object:

public fun create_shared(ctx: &mut TxContext) {
    let obj = SharedObject {
        id: object::new(ctx),
        counter: 0
    };
    transfer::share_object(obj);
}

Entry Functions:

public entry fun do_something(obj: &mut MyObject, value: u64) {
    obj.value = value;
}

CLI Commands

# Create new project
sui move new my_project

# Build
sui move build

# Test
sui move test

# Publish
sui client publish --gas-budget 100000000

# Call function
sui client call --package <PACKAGE_ID> --module <MODULE> --function <FUNCTION> --args <ARGS>

# Get object
sui client object <OBJECT_ID>

Workflow

When answering Sui/Move questions:

1. Search references first:

   rg -i "topic" {baseDir}/references/move-book/book/ -l
   

2. Read relevant files:

   cat {baseDir}/references/move-book/book/<path>/<file>.md
   

3. Provide code examples from the references

4. Link to official docs when helpful:

   • Move Book: https://move-book.com
   • Sui Docs: https://docs.sui.io

Topics Index

Topic	Location
Hello World	move-book/book/your-first-move/hello-world.md
Hello Sui	move-book/book/your-first-move/hello-sui.md
Primitives	move-book/book/move-basics/primitive-types.md
Structs	move-book/book/move-basics/struct.md
Abilities	move-book/book/move-basics/abilities-introduction.md
Generics	move-book/book/move-basics/generics.md
Object Model	move-book/book/object/
Storage	move-book/book/storage/
Events	move-book/book/programmability/events.md
Testing	move-book/book/guides/testing.md
Upgrades	move-book/book/guides/upgradeability.md
PTB	move-book/book/move-advanced/ptb/
BCS	move-book/book/move-advanced/bcs.md

Related Skills

This skill is part of the Sui development skill suite:

Skill	Description
sui-decompile	Fetch and read on-chain contract source code
sui-move	Write and deploy Move smart contracts
sui-coverage	Analyze test coverage with security analysis
sui-agent-wallet	Build and test DApps frontend

Workflow:

sui-decompile → sui-move → sui-coverage → sui-agent-wallet
    Study        Write      Test & Audit   Build DApps

All skills: https://github.com/EasonC13-agent/sui-skills

Notes

• Move 2024 edition introduces new features (enums, method syntax, etc.)
• Sui uses a unique object-centric model different from other blockchains
• Gas is paid in SUI tokens
• Testnet/Devnet available for development