Skill Title
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.
Brief description of what this skill covers and why it exists. Call out the most
common AI-coding mistakes this skill prevents (e.g., using deprecated APIs,
confusing Sui with other chains, misunderstanding the object model).
This skill routes to focused reference files. Load only the ones relevant to the
current task.
All patterns in this skill are derived from:
If unsure about any API, fetch the relevant page before answering.
Do not guess or extrapolate from other SDKs or libraries.
Reference files
Routing guide
| Task |
Load |
| Setting up a new project |
setup |
| Writing core logic |
core |
| Following best practices |
patterns |
| Seeing a worked example |
examples |
| Implementing a complete feature |
core + patterns |
| Full project from scratch |
all reference files |
| Code review |
all reference files |
Skill Content
Key concepts
Rules
Common mistakes
1---2name: your-skill-name3description: Replace with a trigger-style description of when this skill should activate. Be specific — this is what the agent uses to decide whether to load the skill. Example: "Sui TypeScript SDK integration. Use when writing, reviewing, or debugging TypeScript code that interacts with Sui RPCs, transactions, or on-chain state."4---56# Skill Title78> **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.910<!--11 Replace "Skill Title" with a clear name, e.g. "Sui TypeScript SDK Skill".12 The opening paragraph should orient the agent: what domain does this cover,13 what common mistakes does it prevent, and what makes Sui-specific usage14 different from general-purpose patterns?15-->1617Brief description of what this skill covers and why it exists. Call out the most18common AI-coding mistakes this skill prevents (e.g., using deprecated APIs,19confusing Sui with other chains, misunderstanding the object model).2021This skill routes to focused reference files. Load only the ones relevant to the22current task.2324<!--25 Cite the canonical source(s) this skill is derived from (official docs,26 spec, repo, etc.) and instruct the agent to fetch from them when unsure27 rather than guessing or extrapolating from related tools. Example:2829 All patterns in this skill are derived from:30 https://docs.example.com/3132 If unsure about any API, fetch the relevant page before answering.33 Do not guess or extrapolate from other SDKs or libraries.34-->3536All patterns in this skill are derived from:37 <CANONICAL_SOURCE_URL>3839If unsure about any API, fetch the relevant page before answering.40Do not guess or extrapolate from other SDKs or libraries.4142---4344## Reference files4546<!--47 List each supporting markdown file in the skill directory.48 Each entry should follow this format:4950 ### slug — Human-Readable Title51 **Path:** `slug.md`52 **Load when:** describe the tasks/contexts that require this file.53 **Covers:** list the sections or topics inside the file.5455 Tips:56 - Keep files focused on a single concern (setup, syntax, patterns, etc.)57 - Name files with short, descriptive slugs (e.g., setup.md, objects.md)58 - "Load when" should use task-oriented language the agent can match against59-->6061## Routing guide6263<!--64 Map common tasks to which reference files the agent should load.65 This table is the primary decision tool — keep it comprehensive.66 Use "all reference files" for broad tasks like full builds or code review.67-->6869| Task | Load |70|------|------|71| Setting up a new project | setup |72| Writing core logic | core |73| Following best practices | patterns |74| Seeing a worked example | examples |75| Implementing a complete feature | core + patterns |76| Full project from scratch | **all reference files** |77| Code review | **all reference files** |7879## Skill Content8081<!--82 This is where the core knowledge of your skill lives — the rules, guidelines,83 and domain expertise that the agent should always have loaded when this skill84 is active. Unlike reference files (which are loaded on demand), everything in85 this section is available to the agent immediately.8687 Structure this section around:88 - Key concepts the agent must understand to work in this domain89 - Rules and constraints that always apply (e.g., "always use X instead of Y")90 - Common mistakes and how to avoid them91 - Sui-specific differences from general-purpose patterns9293 Keep it concise. If a topic requires extended explanation, examples, or94 reference tables, put it in a reference file instead and link to it from the95 routing guide above.96-->9798### Key concepts99100<!-- Define the core abstractions and mental model for this domain. -->101102### Rules103104<!-- List the non-negotiable rules the agent must follow. Be direct and specific. -->105106### Common mistakes107108<!-- Describe frequent errors and their correct alternatives. -->
jiayaoqijia