Agent Skills - Initia Docs

The Initia Appchain Dev skill is a skill that teaches AI coding agents how to build on Initia. Once installed, your agent can help with:

Chain deployment using the Weave CLI
Smart contract development across all supported VMs
Frontend integration including using InterwovenKit

Installation

Using skills.sh

npx skills add initia-labs/agent-skills

Manual Installation

git clone https://github.com/initia-labs/agent-skills
cd agent-skills
./install.sh

For a project-local install:

./install.sh --project

For a custom destination:

./install.sh --path /custom/path/initia-appchain-dev

Verify Installation

npx skills add . --list

You should see one skill named initia-appchain-dev.

What the Skill Covers

The skill provides reference material organized by layer:

Layer	Coverage
Contracts	Move, Wasm, and EVM contract scaffolding, building, deploying, and testing
Frontend (InterwovenKit)	Provider setup, wallet connection, transactions, auto-sign, bridge
Frontend (EVM JSON-RPC)	wagmi + viem setup for pure EVM apps
Appchain Operations	Weave CLI commands, rollup config schema, runtime discovery
Troubleshooting	Common errors and recovery steps across all layers

skill.md

The Initia docs also provide a skill.md file at docs.initia.xyz/skill.md. This is a lightweight skill file that teaches AI agents how to work with the documentation site itself. To add it:

npx skills add docs.initia.xyz/skill.md

Example Prompts

Once the skill is installed, try prompts like:

“Scaffold an EVM contract on Initia and add an oracle read function.”
“Set up InterwovenKit providers in my Next.js app and implement wallet connect.”
“Create a weave launch config for a testnet EVM rollup.”
“My rollup is not producing blocks. Help me debug it step by step.”
“Convert this 0x... address to Initia bech32 and add it to genesis accounts.”

Reference Material Included

The skill bundles references that your agent reads on demand:

Common tasks — funding, address conversion, token precision
Contracts — Move / Wasm / EVM development guides
Frontend (InterwovenKit) — provider setup, hooks, transactions
Frontend (EVM JSON-RPC) — wagmi + viem integration
End-to-end recipes — full workflows from contract to frontend
Runtime discovery — auto-detecting chain ID, VM, endpoints
Weave CLI commands — complete CLI reference
Rollup config schema — launch configuration format
Troubleshooting — error diagnosis and recovery

Contributing

The skill repository is open source.

Fork the initia-labs/agent-skills repository
Edit the relevant reference files in the skill/references/ directory
Run the quality checks to validate your changes:
./scripts/ci-check.sh
Submit a pull request with a description of what you changed and why

​Installation

​Using skills.sh

​Manual Installation

​Verify Installation

​What the Skill Covers

​skill.md

​Example Prompts

​Reference Material Included

​Contributing