1---2name: mantle3description: Mantle Network hub: chain primer, registry checks, analytics, DeFi planning, contracts. Use when working on Mantle (e.g. verify an address, plan a DeFi route, debug a Mantle RPC error, design a contract for Mantle gas).4---5
6# Skills
7
8`skills/` contains one directory per Mantle-focused agent skill. Each skill combines a primary workflow in `SKILL.md` with local references or assets so the runtime can ground answers in repository data instead of relying only on model memory.
9
10## Directory Convention
11
12- `skills/<skill-name>/SKILL.md`: trigger conditions, workflow, guardrails, and output format
13- `skills/<skill-name>/agents/openai.yaml`: runtime-facing metadata
14- `skills/<skill-name>/references/`: playbooks, policies, templates, and supporting notes
15- `skills/<skill-name>/assets/`: machine-readable local data used by the skill
16
17## Skill Catalog
18
19### Onboarding and Reference
20
21| Skill | Role |
22| --- | --- |
23| [`mantle-network-primer`](./mantle-network-primer/SKILL.md) | Clarifies Mantle fundamentals such as MNT gas, chain IDs, official endpoints, and inclusion vs settlement |
24
25### Registry and Safety Gates
26
27| Skill | Role |
28| --- | --- |
29| [`mantle-address-registry-navigator`](./mantle-address-registry-navigator/SKILL.md) | Resolves verified Mantle addresses and blocks unsafe address guessing |
30| [`mantle-risk-evaluator`](./mantle-risk-evaluator/SKILL.md) | Returns `pass`, `warn`, or `block` verdicts for state-changing intents |
31| [`mantle-portfolio-analyst`](./mantle-portfolio-analyst/SKILL.md) | Inspects balances, allowances, and spender exposure with read-only data |
32
33### Analytics and Diagnostics
34
35| Skill | Role |
36| --- | --- |
37| [`mantle-data-indexer`](./mantle-data-indexer/SKILL.md) | Retrieves historical wallet activity and time-windowed Mantle analytics |
38| [`mantle-readonly-debugger`](./mantle-readonly-debugger/SKILL.md) | Triages RPC failures, quote reverts, and ambiguous read-path behavior |
39| [`mantle-tx-simulator`](./mantle-tx-simulator/SKILL.md) | Prepares external simulation handoffs and WYSIWYS summaries |
40
41### DeFi Planning
42
43| Skill | Role |
44| --- | --- |
45| [`mantle-defi-operator`](./mantle-defi-operator/SKILL.md) | Orchestrates venue discovery, comparison, and execution-ready DeFi planning |
46
47### Smart Contract Lifecycle
48
49| Skill | Role |
50| --- | --- |
51| [`mantle-smart-contract-developer`](./mantle-smart-contract-developer/SKILL.md) | Frames Mantle-specific contract design and deployment-readiness decisions |
52| [`mantle-smart-contract-deployer`](./mantle-smart-contract-deployer/SKILL.md) | Prepares deployment, verification, and external signer handoff steps |
53
54## How to Pick a Skill
55
56- Start with the narrowest skill that matches the task.
57- Use `mantle-network-primer` when Mantle-specific assumptions need to be checked before execution work.
58- Use `mantle-defi-operator` only when the request genuinely spans discovery, address verification, risk evidence, and execution planning.
59- Split contract work between `mantle-smart-contract-developer` and `mantle-smart-contract-deployer` rather than treating deployment as part of design.