# Sui Move Guide

> Route a Sui Move task to the smallest applicable skill sequence. Requires the complete suite installation to execute a route.

- Skill: `josemvcerqueira/sui-move-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add josemvcerqueira/sui-move-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/josemvcerqueira/sui-move-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: josemvcerqueira (https://skillmd.com/u/josemvcerqueira)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/josemvcerqueira/sui-move-guide

---


# Sui Move Guide

Route the task to the smallest set of Sui Move skills that covers the risk. Use
this skill as an explicit catalog, not a coding standard.

## Route the task

1. Decide whether the user wants only a route or wants the route executed. A
   route-only request is complete with a named sequence and one reason per
   selected skill.
2. Inventory every affected boundary and risk, then select the smallest sequence
   that owns all of them. The inventory is complete when each requested change
   maps to at least one selected skill.
3. Before execution, verify every selected sibling skill is installed. If one is
   missing, stop execution and tell the user to install the complete suite;
   still provide the route without recreating the missing rules.
4. Execute the selected skills in the stated order, reading each once. Execution
   is complete only when every selected skill's completion gate is satisfied or
   its evidence gap is reported.

## Skills

- `$sui-move-architecture`: package boundaries, module responsibilities,
  minimal state, reusable value invariants, events and replay, canonical
  authority, dependency direction, on-chain scope, abilities, capabilities,
  and composition seams.
- `$sui-move-source-style`: sections, imports, names, visibility, signatures,
  errors and abort ownership, receiver and index syntax, direct UID access,
  pinned library reuse, locals, API vocabulary, documentation, and test-only
  seams.
- `$sui-move-security`: fail-fast ordering, authorization, signed actions,
  replay, bounded work, arithmetic, custody, integrations, time, oracles,
  randomness, pauses, versions, and upgrades.
- `$sui-move-testing`: risk-based tests, exact failures, guard precedence,
  fixtures, properties, event replay, integrations, upgrades, dependencies, and
  release gates.
- `$sui-move-patterns`: selection and application of the suite's promoted
  reusable designs.
- `$sui-move-review`: one complete audit across all focused standards.

## Common routes

### Design a new package or major feature

Apply architecture before public ABI or storage, then security, source style,
and testing. Finish with review. Read each standard only once per task.

### Change an existing state transition

Apply security, source style, and testing. Add architecture when state
ownership, authority, abilities, visibility, storage, event emission, replay,
or package boundaries can change. Source style owns any changed error
representation; security owns guard behavior and precedence.

### Add or change a module, type, or public API

Apply architecture and source style. Add security for authority, asset,
lifecycle, or shared-state types. Preserve published function signatures and
datatype layouts; the focused skills own migration details.

### Upgrade a package or migrate state

Apply architecture, security, source style, and testing. Load architecture's
event reference or source style's error reference when indexed or diagnostic
behavior changes. Finish with review for a release-wide audit.

### Add events or errors

For events, apply architecture and testing. For errors, apply source style and
testing; add security when guard order, authorization, or transition behavior
can change.

### Audit redundancy or simplify Move code

Apply architecture to state, public seams, events, and replay; apply source
style to code shape and errors; apply testing before removal. Add security when
simplification can change guards, authority, assets, composition, or evaluation
order.

### Build or repair tests

Apply testing plus the focused skill that owns the behavior under test. Tests
prove rules; they do not invent them.

### Select, compare, or apply a reusable pattern

Apply patterns when the task asks for a named reusable design or matches a
promoted pattern's problem. Then apply only the focused standards that own the
selected design's invariants.

### Review a branch or pull request

Use review. It loads every focused standard and requires the complete suite.

## Routing rule

Use a focused skill for a narrow question. When uncertainty could affect
behavior, include security and testing. Keep source style, architecture, and
security distinct: each must cover the risks it owns.

The route is complete when every affected boundary and risk has an owner, no
selected skill is redundant, and the execution order preserves design before
implementation and tests before final review.