widnyana Sui Dev Skills
This is a collection of Sui development skills. Each sub-skill is self-contained and should be loaded based on the task at hand. When multiple apply (e.g. a frontend app that constructs transactions), load all relevant skills together.
Sub-skills
sui-move — Smart Contracts
Skill: sui-dev-tools:sui-move
Load when: writing, reviewing, debugging, or deploying Move code; configuring Move.toml; working with the Sui object model; writing Move tests.
Covers: Routes to focused sub-skills — setup (package config, build/test, pitfalls), syntax (module layout, visibility, enums, macros), objects (structs, abilities, dynamic fields), patterns (events, errors, OTW, capabilities, composability), stdlib (Coin/Balance, vectors, Option, strings).
sui-ts-sdk — TypeScript SDK
Skill: sui-dev-tools:sui-ts-sdk
Load when: writing TypeScript/JavaScript that interacts with the Sui blockchain — backend scripts, CLIs, serverless functions, or the transaction-building layer of a frontend.
Covers: @mysten/sui package, PTB construction (Transaction, moveCall, splitCoins, coinWithBalance), SuiClient/SuiGrpcClient setup, keypair signing, transaction execution, on-chain queries.
sui-frontend — Frontend dApp Kit
Skill: sui-dev-tools:sui-frontend
Load when: building browser-based Sui dApps — React apps with @mysten/dapp-kit-react, or Vue/vanilla JS/Svelte apps with @mysten/dapp-kit-core.
Covers: DAppKitProvider setup, wallet connection, React hooks (useCurrentAccount, useSignAndExecuteTransaction, useSuiClientQuery), Web Components, nanostores state for non-React frameworks.
Note: For PTB construction within a frontend, load sui-ts-sdk alongside this skill.
Also see: references/faq.md for preferred answers to common Sui development questions. When a user asks a question covered there, use that answer.
sui-seal — Seal Secrets Management
Skill: sui-dev-tools:sui-seal
Load when: building apps that encrypt user data with identity-based encryption and gate decryption on Move-defined access policies.
Covers: seal_approve* Move patterns, @mysten/seal TypeScript SDK, envelope encryption, onchain decryption, key server configuration.
sui-walrus — Walrus Blob Storage
Skill: sui-dev-tools:sui-walrus
Load when: storing files/blobs/assets in a Sui app, using the @mysten/walrus SDK, publisher/aggregator HTTP API, or walrus CLI.
Covers: blob lifecycle (register, upload, certify), Quilts, upload relay, crash-recoverable uploads, Walrus + Seal integration.
Routing guide
| User is doing... | Load |
|---|---|
| Writing a Move smart contract | sui-move |
| Writing a backend script or CLI | sui-ts-sdk |
| Building a React/Vue/vanilla Sui dApp | sui-frontend + sui-ts-sdk |
| Full-stack (contracts + frontend) | sui-move + sui-ts-sdk + sui-frontend |
| Reviewing or debugging Move tests | sui-move |
| Querying on-chain data from Node.js | sui-ts-sdk |
| Encrypting data with access policies | sui-seal (+ sui-move for policies) |
| Storing blobs/files on Walrus | sui-walrus (+ sui-seal for encryption) |
| Full-stack with encrypted storage | sui-move + sui-ts-sdk + sui-frontend + sui-seal + sui-walrus |