Skip to main content
skill CX Codex

kiosk — Claude Code skill for Sui Kiosk: features and install

This Claude Code skill supports writing, reviewing, and debugging Move code for Sui Kiosk. It covers asset trading, NFT listings, TransferPolicy, and Kiosk extensions.

Apache-2.0 162 installs ★ 25 updated 2026-11-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MystenLabs/skills --skill kiosk -a claude-code
Open on GitHub

What kiosk does

The skill explains Kiosk operations, from creating a Kiosk and placing assets to listing items, completing purchases, and withdrawing sale proceeds. It covers PLACED, LOCKED, and LISTED states, borrowing patterns, and TransferPolicy rules. A trade requires a policy for the asset type, and every policy term must be satisfied to resolve the TransferRequest.

Reference material is split between core.md for Kiosk operations and apps.md for apps and extensions. The skill routes a task to the relevant file; full integrations and code reviews use both. Listing prices are denominated in MIST. Locked items cannot be taken out of a Kiosk.

What it helps with

  • create a Kiosk and place assets in it
  • trace a failed purchase to a missing TransferPolicy
  • check which operations an asset state permits
  • build a permissioned Kiosk extension

Example prompts for the agent

  • Review this Move purchase flow and find problems with its TransferPolicy.
  • Explain whether an asset in the LOCKED state can be taken out.
  • Help me build a Kiosk extension with placement and locking permissions.

How to install kiosk

1Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill kiosk -a claude-code

2Manually: put the files in place

~/.claude/skills/kiosk/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/kiosk/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about kiosk

How do I install kiosk in Claude Code?

Run npx skills add MystenLabs/skills --skill kiosk -a claude-code. The skill file is located at ~/.claude/skills/kiosk/SKILL.md.

What does kiosk do?

It helps with Move code for Sui Kiosk, including asset operations, trading rules, and Kiosk apps or extensions.

Which Kiosk asset states does kiosk explain?

It covers PLACED, LOCKED, LISTED, and LISTED EXCLUSIVELY. Their rules determine whether an item can be withdrawn, borrowed, or listed.

Source text

SKILL.md · Apache-2.0
---
name: kiosk
description: >
  Sui Kiosk and NFT trading primitives. Use when writing, reviewing, or debugging
  Move code that uses Kiosk for commerce, NFT trading, asset listing, TransferPolicy
  enforcement, or building Kiosk Apps and extensions. Also use when the user asks
  about asset states (PLACED, LOCKED, LISTED), borrowing patterns, purchase flows,
  or the kiosk_extension permissioned apps API.
---

# Sui Kiosk Skill

> **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/standards/kiosk](https://docs.sui.io/standards/kiosk). When extending or updating this skill, only pull from this source. Do not use third-party blogs, tutorials, or unofficial documentation.

Kiosk is a decentralized system for commerce applications on Sui, providing shared objects that store assets with built-in trading functionality including custom trade mechanisms like auctions. This skill covers Kiosk creation, asset management, listing and purchase flows, TransferPolicy enforcement, borrowing patterns, and the Kiosk Apps extension API. Common mistakes include forgetting that a TransferPolicy is required before items can be traded, attempting to mutably borrow listed items, and misunderstanding the permissions bitmap for Kiosk Apps.

This skill routes to focused reference files. Load only the ones relevant to the current task.

All patterns in this skill are derived from:
  https://docs.sui.io/standards/kiosk

If unsure about any API, fetch the relevant page before answering.
Do not guess or extrapolate from other protocols or NFT standards.

---

## Reference files

### core -- Core Kiosk Operations
**Path:** `core.md`
**Load when:** the user needs to create a Kiosk, place or take assets, list or delist items, purchase items, understand TransferPolicy and the purchase flow, understand asset states (PLACED, LOCKED, LISTED, LISTED EXCLUSIVELY), borrow assets, or withdraw sale proceeds.
**Covers:** Kiosk creation, KioskOwnerCap, placing and taking items, locking items, listing and delisting, purchase flow with TransferRequest, TransferPolicy, asset states, immutable and mutable borrowing, the borrow_val hot potato pattern, access control, withdrawal.

### apps -- Kiosk Apps and Extensions
**Path:** `apps.md`
**Load when:** the user needs to build basic Kiosk apps using dynamic fields, build permissioned apps with the kiosk_extension module, understand the permissions bitmap, manage app lifecycle (install, enable, disable, remove), or use app-isolated storage.
**Covers:** basic apps via UID dynamic fields, uid_mut_as_owner, the Kiosk Name app example, permissioned apps via kiosk_extension, app lifecycle, permissions bitmap (place, lock), protected functions, permission checking, app storage (bag-type isolated storage).

---

## Routing guide

| Task | Load |
|------|------|
| Creating a Kiosk | core |
| Placing, taking, or locking items | core |
| Listing or delisting items | core |
| Purchasing items and satisfying TransferPolicy | core |
| Understanding asset states | core |
| Borrowing assets (immutable, mutable, PTB-friendly) | core |
| Withdrawing sale proceeds | core |
| Building a basic Kiosk app with dynamic fields | apps |
| Building a permissioned Kiosk extension | apps |
| Understanding permissions bitmap | apps |
| Managing app lifecycle (install, enable, disable, remove) | apps |
| Using app-isolated storage | apps |
| Full Kiosk integration | **all reference files** |
| Code review of Kiosk code | **all reference files** |

---

## Skill Content

### Key concepts

- **Kiosk.** A shared object that stores assets with built-in trading functionality. Created via `kiosk::default`, which shares the Kiosk and transfers the `KioskOwnerCap` to the creator.

- **KioskOwnerCap.** The capability that grants ownership over a Kiosk. Only the cap owner can place, take, list, borrow, or modify assets in the Kiosk.

- **TransferPolicy.** A shared object associated with asset type `T` that defines the rules all trades of that type must satisfy. Without an associated TransferPolicy, items of type `T` cannot be traded (storage is still possible). Policy changes apply instantly and globally across all platform trades.

- **TransferRequest.** A hot potato returned by `kiosk::purchase` that must be resolved by satisfying all TransferPolicy terms before the transaction completes.

- **Asset states.** Items in a Kiosk exist in one of four states: PLACED (withdrawable, borrowable, listable), LOCKED (non-withdrawable but mutable-borrowable and listable), LISTED (immutably borrowable only, no modifications), and LISTED EXCLUSIVELY (extension-managed via `kiosk::list_with_purchase_cap`).

- **MIST.** The smallest unit of SUI. 1 SUI = 10^9 MIST. Listing prices are specified in MIST.

### Rules

1. **A TransferPolicy must exist for type `T` before items of that type can be traded.** Without one, `kiosk::purchase` cannot complete. Items can still be stored (placed) without a TransferPolicy.
2. **Listed items cannot be mutably borrowed.** Only immutable borrows are available for items in the LISTED state.
3. **Locked items cannot be withdrawn.** Items placed via `kiosk::lock` require an associated TransferPolicy and cannot be taken out of the Kiosk, only listed and sold.
4. **The `borrow_val` hot potato must be returned via `return_val`.** Failure to return causes a transaction abort.
5. **Only the KioskOwnerCap holder can modify Kiosk contents.** All place, take, list, borrow, and withdrawal operations require the cap.

### Common mistakes

- **Forgetting the TransferPolicy.** Attempting to purchase an item type that has no associated TransferPolicy causes the transaction to fail. Ensure a TransferPolicy is created and shared before trading.
- **Mutably borrowing a listed item.** Items in the LISTED state only support immutable borrows. Attempting `borrow_mut` on a listed item fails.
- **Confusing PLACED and LOCKED states.** PLACED items can be withdrawn with `kiosk::take`; LOCKED items cannot. Use `kiosk::lock` only when you want to enforce that items can only leave the Kiosk through a sale.
- **Not satisfying all TransferPolicy terms.** The `TransferRequest` returned by `kiosk::purchase` must satisfy every rule in the TransferPolicy. Missing even one causes the transaction to abort.
- **Using SUI instead of MIST for listing prices.** `kiosk::list` expects prices in MIST (1 SUI = 10^9 MIST). Passing a price of `1` means 1 MIST, not 1 SUI.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Similar skills

SKILL.md skills catalog →

From the same set30

The whole set →
deepbook-margin The deepbook-margin Claude Code skill explains margin trading on DeepBook on Sui. It covers borrowed positions, collateral, risk ratios, and liquidation. CX Codex +1 181installs deepbook-move The deepbook-move Claude Code skill guides Move contract work with DeepBook V3. It covers pools, orders, swaps, flash loans, and BalanceManager permissions. CX Codex +1 181installs deepbook-predict This Claude Code skill covers DeepBook Predict integration for prediction markets on Sui. It explains position creation, settlement, and the liquidity pool. CX Codex +1 181installs sui-ts-sdk-backend The sui-ts-sdk-backend Claude Code skill covers backend services and agents that interact with Sui through the TypeScript SDK. It is invoked for client setup, transaction signing, package publishing, and high-throughput execution. CX Codex +1 167installs zklogin Explains zkLogin and guides its integration into Sui apps. It activates for questions about OpenID providers, address derivation, session lifetime, or security. CX Codex +1 164installs onchain-randomness Guides onchain randomness implementation in Sui Move. Secures functions using the 0x8 Random object against composition and PTB attacks. CX Codex +1 162installs sui-bridge This Claude Code skill explains Sui Bridge and answers questions about transfers between Sui and Ethereum. It activates for queries about supported assets, limits, finality, or validator governance. CX Codex +1 160installs sui-for-ethereum The sui-for-ethereum Claude Code skill explains how Sui Move differs from Ethereum and Solidity. It activates for pattern comparisons, token mappings, and contract migration questions. CX Codex +1 159installs

Project sponsors

Companies that keep this analytics open