К основному содержанию
скилл CX Codex

composable-move-functions — скилл для Claude Code: установка

Скилл composable-move-functions для Claude Code задаёт правила оформления функций на языке Move в блокчейне Sui. Включается при проектировании публичных сигнатур, порядка параметров и возврата объектов для транзакций PTB.

Apache-2.0 616 установок ★ 25 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MystenLabs/skills --skill composable-move-functions -a claude-code
Открыть на GitHub

Что делает composable-move-functions

Скилл учит агента писать компонуемые функции на Move для программируемых транзакционных блоков (PTB) в Sui. Он запрещает связку public entry, разделяя функции на компонуемые public и отдельные точки входа entry. Публичные методы должны возвращать созданные структуры наружу, а не пересылать их через transfer::transfer внутри функции.

Внутри зафиксирован строгий порядок параметров: сначала основные объекты, затем токены прав доступа (capabilities), потом примитивные значения, объект Clock и последним аргументом ctx: &mut TxContext. Функции с возвратом не-drop структур не вызываются через sui client call из-за ошибки UnusedValueWithoutDrop, поэтому для них применяется sui client ptb либо вспомогательная обёртка entry.

При наличии в окружении MCP-сервера https://sui.mcp.kapa.ai скилл обращается к нему за проверкой актуальных деталей документации Sui.

Какие задачи решает

  • запретить связку модификаторов public entry в модулях Move
  • организовать возврат созданных объектов вместо внутренней отправки в кошелёк
  • выстроить аргументы функции в последовательности от объектов к TxContext
  • подготовить публичные методы Sui к объединению внутри транзакций PTB

Примеры запросов агенту

  • Напиши публичную функцию mint для NFT на Sui без передачи объекта внутри
  • Сделай функцию вывода ликвидности с правильным порядком параметров и возвратом токенов
  • Оформи точку входа entry для вызова метода create_thing через CLI

Как установить composable-move-functions

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill composable-move-functions -a claude-code

2Вручную: положить файлы

~/.claude/skills/composable-move-functions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/composable-move-functions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о composable-move-functions

Как установить composable-move-functions в Claude Code?

Выполните команду npx skills add MystenLabs/skills --skill composable-move-functions -a claude-code. Также можно сохранить файл по пути ~/.claude/skills/composable-move-functions/SKILL.md.

Что делает composable-move-functions?

Скилл направляет модель при написании смарт-контрактов на Move под Sui, требуя возвращать объекты вместо их передачи внутри метода и соблюдать порядок аргументов.

Почему нельзя использовать связку public entry в Sui Move?

Связка public entry ограничивает компонуемость в блоках PTB. Скилл требует объявлять либо возвращающие результат функции public, либо отдельные сервисные точки входа entry для CLI.

Исходный текст

SKILL.md · Apache-2.0
---
name: composable-move-functions
description: Use when writing Move functions on Sui, especially public APIs. Applies to function visibility (public vs entry), parameter ordering, and return patterns. Use whenever designing function signatures or deciding whether functions should transfer objects or return them.
---

# composable-move-functions

> **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.

## Overview

Sui transactions can chain multiple function calls in a single Programmable Transaction Block (PTB). Functions that transfer objects internally instead of returning them break this composability. This skill covers how to design functions that work well in PTBs.

All patterns sourced from https://move-book.com/guides/code-quality-checklist

## No `public entry`

Functions should be either `public` (composable, can be called from other modules and PTBs) or `entry` (transaction endpoint only). Never use `public entry` together.

```move
// WRONG — public entry is redundant and limits composability
public entry fun do_something() { }

// CORRECT — public for composable functions that return values
public fun mint(ctx: &mut TxContext): NFT { }

// CORRECT — entry for intentionally non-composable endpoints
entry fun mint_and_keep(ctx: &mut TxContext) { }
```

**When to use `entry`:** Only for convenience endpoints that are intentionally non-composable — functions that wrap a composable `public` function and handle transfers to sender.

## Return Objects, Don't Transfer Internally

Public functions should return values to the caller rather than transferring them to `ctx.sender()`. This makes them composable in PTBs — the caller decides what to do with the result.

```move
// WRONG — couples minting with transfer, can't compose
public fun mint_and_transfer(ctx: &mut TxContext) {
    let nft = NFT { id: object::new(ctx) };
    transfer::transfer(nft, ctx.sender());
}

// CORRECT — returns the object, caller decides
public fun mint(ctx: &mut TxContext): NFT {
    NFT { id: object::new(ctx) }
}

// If you need a convenience entry point, add a separate entry wrapper:
entry fun mint_and_keep(ctx: &mut TxContext) {
    let nft = mint(ctx);
    transfer::transfer(nft, ctx.sender());
}
```

### CLI implication for returned values

Functions that return non-`drop` values cannot be invoked via `sui client call` — the CLI has no way to consume the returned value, causing an `UnusedValueWithoutDrop` error. Use `sui client ptb` instead, where you can chain `--assign` and `--transfer-objects` to handle the return value:

```bash
sui client ptb \
  --move-call @pkg::module::create_thing --assign thing \
  --transfer-objects "[thing]" @sender
```

If the function is called frequently from the CLI, consider providing a companion `entry` wrapper that transfers internally (as shown above).

This applies broadly:
- `add_liquidity` should return LP coins and remainder coins, not transfer them
- `remove_liquidity` should return both coins, not transfer them
- `swap` should return the output coin, not transfer it
- `borrow` should return the borrowed asset, not transfer it

## Parameter Ordering

Function parameters follow a strict order:

1. **Objects first** — the primary object being acted on
2. **Capabilities second** — authorization tokens like `AdminCap`
3. **Primitive values** — amounts, flags, addresses
4. **Clock** — always at the end (before ctx), exception to objects-first rule
5. **`ctx: &mut TxContext` last** — ALWAYS the final parameter, after all primitives and all other arguments

```move
// WRONG — cap before object, primitives mixed in
public fun authorize_action(
    cap: &AdminCap,
    value: u8,
    app: &mut App,
    ctx: &mut TxContext,
) { }

// CORRECT — object first, cap second, primitives third, ctx last
public fun authorize_action(
    app: &mut App,
    cap: &AdminCap,
    value: u8,
    ctx: &mut TxContext,
) { }
```

### Clock Exception

`Clock` goes near the end, just before `ctx`, even though it's an object:

```move
public fun timed_action(
    app: &mut App,
    cap: &AppCap,
    value: u8,
    clock: &Clock,
    ctx: &mut TxContext,
) { }
```

## Quick Reference

| Pattern | Rule |
|---------|------|
| Visibility | `public` for composable, `entry` for endpoints. Never `public entry`. |
| Returns | Public functions return objects. Don't transfer to sender internally. |
| Entry wrappers | Separate `entry` function that calls `public` function + transfers. |
| Param order | Object → Capability → Primitives → Clock → TxContext |

© MystenLabs · Apache-2.0 · MystenLabs/skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →
move-code-quality davila7 Скилл move-code-quality разбирает пакеты на языке Move по чек-листу качества из Move Book и подсказывает, что поправить под Move 2024 Edition. CX Codex +1 100установок entry-point-analyzer trailofbits Скилл entry-point-analyzer находит внешние функции смарт-контрактов, которые меняют состояние, и группирует их по уровню доступа. Нужен перед аудитом, чтобы очертить поверхность атаки. CX Codex +1 6 400установок aptos-agent-skills aptos-labs Набор скиллов для разработки на Aptos: контракты Move, TypeScript SDK, аудит безопасности и оптимизация газа. ★ 21звёзд репо Sui Knowledge Base (kapa.ai) MystenLabs Sui Knowledge Base (kapa.ai) — MCP-сервер для Claude Code и других платформ: ищет ответы в документации Sui по смыслу запроса и возвращает точные ссылки вместо списка файлов. CX Codex +1 ★ 7 782звёзд репо solidity-security Seth Hobson Скилл solidity-security для Claude Code помогает писать и проверять Solidity-контракты с учётом типовых уязвимостей. Помогает при аудите, работе с DeFi и подготовке к профессиональной проверке. CX Codex +1 15 382установок blockchain-expert personamanagmentlayer Скилл blockchain-expert для Claude Code разбирает блокчейн, Web3, Solidity, смарт-контракты и DeFi. Помогает проектировать, тестировать и аудировать криптосистемы. CX Codex +1 296установок

Из того же набора30

Весь набор →
sui-move Скилл sui-move для Claude Code, Codex и Cursor управляет написанием, проверкой и отладкой смарт-контрактов на Move в блокчейне Sui. CX Codex +1 633установок naming-conventions Скилл naming-conventions для Claude Code задаёт правила именования в Move-контрактах для Sui. Агент применяет их при создании и проверке типов, функций и констант. CX Codex +1 621установок sui-move-project Скилл sui-move-project для Claude Code настраивает Move-проекты в Sui и разбирает ошибки Move.toml, зависимостей и сборки. Срабатывает при создании проекта и миграции старого формата. CX Codex +1 620установок sui-object-model Скилл sui-object-model для Claude Code описывает модель объектов Sui и помогает разбирать владение, передачу и хранение данных в Sui Move. Подключается к вопросам о выборе типа владения или структуры для данных. CX Codex +1 617установок move-unit-testing Скилл move-unit-testing для Claude Code помогает писать модульные тесты для смарт-контрактов Move на Sui. Подключается, когда нужно создать тесты или добавить их к модулю Move. CX Codex +1 615установок sui-build Скилл sui-build для Claude Code помогает собирать пакеты Move командой sui move build. Агент подключает его, когда нужно написать или собрать Move-код либо ответить на вопрос о sui move build. CX Codex +1 613установок modern-move-syntax Скилл modern-move-syntax для Claude Code переводит генерацию смарт-контрактов Sui на синтаксис Move 2024. Он заменяет вызовы функций модулей на вызовы методов через точку, макросы и литералы. CX Codex +1 613установок accessing-data Скилл accessing-data для Claude Code подсказывает архитектуру чтения данных из блокчейна Sui: gRPC, GraphQL RPC, Archival Store, Walrus или sui-indexer-alt. Включается при запросах балансов, объектов и миграции. CX Codex +1 491установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой