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

naming-conventions — скилл для Claude Code: правила Move

Скилл naming-conventions для Claude Code задаёт правила именования в Move-контрактах для Sui. Агент применяет их при создании и проверке типов, функций и констант.

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

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

Что делает naming-conventions

Скилл задаёт соглашения об именах для элементов Move-контрактов на Sui. Константы ошибок получают префикс E и PascalCase, обычные константы пишутся в ALL_CAPS, а структуры возможностей заканчиваются на Cap. События называют в прошедшем времени. Геттер получает имя поля без get_, а изменяемый геттер — суффикс _mut. Типы hot potato не включают слово Potato, а ключи динамических полей оформляют как позиционные структуры с суффиксом Key. Для новых констант ошибок с #[error] типом служит vector<u8>; компилятор назначает числовые коды автоматически. Для актуальных сведений можно также обратиться к MCP-серверу документации Sui, если он доступен.

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

  • назвать константу ошибки в Move
  • оформить структуру capability с нужным суффиксом
  • переименовать событие в прошедшее время
  • убрать get_ из имени геттера
  • задать типу ключа динамического поля суффикс Key

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

  • Проверь имена типов и констант в Move-контракте на Sui.
  • Предложи имена для новых событий и геттеров в этом Move-модуле.
  • Проверь, соответствуют ли ключи динамических полей правилам Sui.

Как установить naming-conventions

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill naming-conventions -a claude-code

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

~/.claude/skills/naming-conventions/SKILL.md

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

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

Вопросы о naming-conventions

Как установить naming-conventions в Claude Code?

Выполни npx skills add MystenLabs/skills --skill naming-conventions -a claude-code. Файл скилла находится по пути ~/.claude/skills/naming-conventions/SKILL.md.

Что делает naming-conventions?

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

Какие правила он задаёт для констант ошибок?

Имена используют префикс E и PascalCase. Для новых констант с атрибутом #[error] применяется тип vector<u8>, а числовой код назначает компилятор.

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

SKILL.md · Apache-2.0
---
name: naming-conventions
description: Use when writing or reviewing Move smart contracts on Sui. Applies to naming structs, error constants, regular constants, events, getter functions, capability types, hot potato types, and dynamic field keys. Use whenever creating new types, functions, or constants in Move code.
---

# naming-conventions

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

Move on Sui has specific naming conventions that differ from what AI agents typically generate from training data. This skill covers every naming pattern from the official code quality checklist.

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

## Error Constants: EPascalCase with `#[error]`

Error constants MUST use PascalCase with an `E` prefix. Do NOT use SCREAMING_SNAKE_CASE.

Use the `#[error]` attribute to attach human-readable messages to error constants. When an abort occurs, the message is included in the error output, making debugging much easier for users and support.

```move
// WRONG
const NOT_AUTHORIZED: u64 = 0;
const INSUFFICIENT_BALANCE: u64 = 1;

// CORRECT — with #[error] for readable abort messages
#[error]
const ENotAuthorized: vector<u8> = b"Caller is not authorized to perform this action";
#[error]
const EInsufficientBalance: vector<u8> = b"Insufficient balance for this operation";

// Also valid — u64 without #[error] (less informative on abort)
const ENotAuthorized: u64 = 0;
const EInsufficientBalance: u64 = 1;
```

When using `#[error]`, the constant type is `vector<u8>` (a byte string message) instead of `u64`. The compiler assigns numeric codes automatically. Prefer `#[error]` for all new code — it produces clearer error output in explorers, wallets, and logs.

## Regular Constants: ALL_CAPS

Non-error constants use uppercase snake_case. This is the opposite of error constants.

```move
// WRONG
const MyConstant: vector<u8> = b"hello";
const feeNumerator: u64 = 3;

// CORRECT
const MY_CONSTANT: vector<u8> = b"hello";
const FEE_NUMERATOR: u64 = 3;
```

## Capability Structs: `Cap` Suffix

Any struct that represents a capability (authorization to perform actions) MUST be suffixed with `Cap`.

```move
// WRONG
public struct Admin has key, store { id: UID }
public struct MintAuthority has key, store { id: UID }

// CORRECT
public struct AdminCap has key, store { id: UID }
public struct MintCap has key, store { id: UID }
```

## Events: Past Tense

Event struct names MUST use past tense to indicate something that already happened.

```move
// WRONG
public struct RegisterUser has copy, drop { user: address }
public struct CreatePool has copy, drop { pool_id: ID }
public struct LevelUp has copy, drop { new_level: u64 }

// CORRECT
public struct UserRegistered has copy, drop { user: address }
public struct PoolCreated has copy, drop { pool_id: ID }
public struct LeveledUp has copy, drop { new_level: u64 }
```

## Getter Functions: Field Name, Not `get_`

Getter functions should be named after the field they return, without a `get_` prefix. Mutable getters add `_mut` suffix.

```move
// WRONG
public fun get_name(u: &User): String { u.name }
public fun get_balance(u: &User): u64 { u.balance }

// CORRECT
public fun name(u: &User): String { u.name }
public fun balance(u: &User): u64 { u.balance }
public fun details_mut(u: &mut User): &mut Details { &mut u.details }
```

## Hot Potato Structs: No `Potato` in Name

Hot potato types (structs with no abilities) should NOT include "Potato" in the name. The absence of abilities already signals the pattern.

```move
// WRONG
public struct FlashLoanPotato {}
public struct PromisePotato {}

// CORRECT
public struct FlashLoanReceipt {}
public struct Promise {}
```

## Dynamic Field Keys: Positional Struct with `Key` Suffix

Dynamic field key types should use positional struct syntax (empty parentheses) with a `Key` suffix.

```move
// WRONG
public struct DynamicField has copy, drop, store {}
public struct ItemSlot has copy, drop, store { name: String }

// CORRECT
public struct DynamicFieldKey() has copy, drop, store;
public struct ItemKey(String) has copy, drop, store;
```

## Quick Reference

| Element | Convention | Example |
|---------|-----------|---------|
| Error constants | `E` + PascalCase | `ENotAuthorized` |
| Regular constants | ALL_CAPS | `FEE_NUMERATOR` |
| Capabilities | Suffix with `Cap` | `AdminCap` |
| Events | Past tense | `PoolCreated` |
| Getters | Field name, no `get_` | `balance()` |
| Mutable getters | Field name + `_mut` | `balance_mut()` |
| Hot potatoes | Descriptive, no `Potato` | `FlashLoanReceipt` |
| Dynamic field keys | Positional + `Key` suffix | `ItemKey()` |

© MystenLabs · Apache-2.0 · MystenLabs/skills

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

Каталог скиллов SKILL.md →
golang-naming samber Скилл golang-naming задаёт правила имён в Go: пакеты, типы, ошибки, булевы поля и тесты. Пригодится при написании, ревью и рефакторинге кода. CX Codex +1 43 300установок bencium-code-conventions bencium Скилл bencium-code-conventions задаёт правила Bence для React и Next.js: стек, стиль кода, тесты и рабочий процесс. Нужен при создании или настройке проекта по этим соглашениям. CX Codex +1 3 500установок brand-naming arnabbagxd Скилл brand-naming для Claude Code ведёт от брифа до списка названий бренда и их оценки. Генерирует имена или разбирает уже выбранные варианты. CX Codex +1 2 800установок naming-convention Owl-Listener Скилл naming-convention задаёт единые правила именования компонентов, токенов и слоёв, чтобы имена в проекте не расходились от файла к файлу. CX Codex +1 2 500установок platform-conventions Owl-Listener Скилл platform-conventions для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 1 500установок go-naming cxuu Скилл go-naming для Claude Code следит за именами в Go: пакеты, типы, функции, константы, получатели. Запускается при создании новых типов, пакетов и экспортируемого API. CX Codex +1 1 300установок

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

Весь набор →
sui-move Скилл sui-move для Claude Code, Codex и Cursor управляет написанием, проверкой и отладкой смарт-контрактов на Move в блокчейне Sui. CX Codex +1 633установок 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установок composable-move-functions Скилл composable-move-functions для Claude Code задаёт правила оформления функций на языке Move в блокчейне Sui. Включается при проектировании публичных сигнатур, порядка параметров и возврата объектов для транзакций PTB. CX Codex +1 616установок 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установок

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

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