XPR Network Developer Skill for Claude Code

A comprehensive skill package that enhances Claude's capabilities for XPR Network blockchain development. This skill provides Claude with deep knowledge of smart contract development, CLI tools, frontend integration, and best practices specific to the XPR Network ecosystem.

What is XPR Network?

XPR Network is a fast, gas-free blockchain with WebAuthn wallet support. Key features:

• Zero gas fees - Users don't pay transaction fees
• WebAuthn wallets - Login with Face ID, fingerprint, or security keys
• 4000+ TPS - Fast block times (0.5s)
• EOS-based - Uses EOSIO technology with AssemblyScript smart contracts
• Human-readable accounts - 12 character account names instead of hex addresses

Installation

The easy way:

git clone https://github.com/XPRNetwork/xpr-network-dev-skill.git
cd xpr-network-dev-skill
./install.sh

Updating

If you installed via git clone, pull the latest version:

cd xpr-network-dev-skill
git pull

Your agent will use the updated skill automatically on the next conversation. No reinstall needed — the symlink points to the local directory.

v2.0.0 (March 2026): Major accuracy audit — 40+ fixes across 13 files. All contract actions, params, and tables verified against live mainnet ABIs. Critical fixes for DEX deposits, LOAN protocol, oracle indices, and more. See PR #10 for details.

Method 1: Manual symlink (personal skill)

Personal skills are available across all your projects:

git clone https://github.com/XPRNetwork/xpr-network-dev-skill.git
mkdir -p ~/.claude/skills
ln -s /path/to/xpr-network-dev-skill/skill ~/.claude/skills/xpr-network-dev

Method 2: Project-level skill

To make the skill available only in a specific project:

mkdir -p .claude/skills
ln -s /path/to/xpr-network-dev-skill/skill .claude/skills/xpr-network-dev

Commit .claude/skills/xpr-network-dev to version control so teammates get the skill automatically.

Method 3: Copy to project CLAUDE.md

Copy relevant sections from skill/SKILL.md directly into your project's CLAUDE.md file. This is the simplest approach but the content always loads into context rather than on-demand.

Usage with Other AI Tools

This skill is just structured markdown - it works with any AI coding assistant, not just Claude Code.

Cursor

Option A: .cursorrules

# Copy relevant modules into your .cursorrules file
cat skill/smart-contracts.md >> .cursorrules

Option B: Reference in prompts

@skill/smart-contracts.md How do I create a singleton table?

Option C: Add as documentation
Add the skill/ folder to your project and Cursor will index it.

GitHub Copilot / Other Tools

Copy relevant module content into your prompt context or project documentation. The knowledge is tool-agnostic.

Direct Reference

For any AI tool, you can paste sections directly:

"I'm building on XPR Network. Here's the relevant documentation: [paste from skill/smart-contracts.md]"

Skill Modules

Core Development

Tokens & Identity

DeFi & Trading

Integration Patterns

Infrastructure

Safety & Reference

Usage with Claude Code

Once installed, Claude will automatically use this knowledge when you ask about XPR Network development:

"How do I deploy a smart contract on XPR Network?"
"Query a table using proton CLI"
"Create a token transfer action"
"What's the safe way to add a field to a table?"

Claude will load specialized modules on demand based on your queries.

Key Topics Covered

Smart Contract Development

• AssemblyScript/TypeScript contracts with @proton/ts-contracts
• Table definitions (@table, @primary, singletons)
• Actions, authentication, inline actions
• Build and deploy workflow
• Unit testing with @proton/vert

CLI Operations

• Network management (chain:set, chain:get)
• Key management (key:add, key:list)
• Contract deployment (contract:set)
• Table queries and action execution
• Account creation and permissions

Frontend Integration

• @proton/web-sdk for wallet connection
• Session management and transaction signing
• RPC queries with @proton/js
• WebAuth and KYC verification

Backend Development

• Server-side transaction signing
• Automated bots and scheduled tasks
• Security best practices for key management
• Hyperion and Light API integration

Token & Identity

• Fungible token creation and management
• Token vesting and airdrops
• WebAuth wallet integration
• User profiles and KYC status
• Trust rating system

NFT Development

• AtomicAssets standard (collections, schemas, templates, assets)
• Minting, transfers, and marketplace integration
• IPFS integration for media storage

DeFi and Trading

• MetalX DEX integration (order book, trades)
• Trading bot patterns (grid bot, market maker)
• Perpetual futures architecture and building blocks
• LOAN lending protocol (supply, borrow, liquidations)

Safety & Troubleshooting

• CRITICAL: Never modify existing table structures with data
• Pre-deployment checklist
• Recovery procedures
• Multi-contract deployment safety
• Common errors and solutions

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Test your changes with Claude Code
4. Submit a pull request

Areas for Contribution

• Additional code examples
• New patterns from production contracts
• Corrections and clarifications
• Translations

Resources

• Official Docs: https://docs.xprnetwork.org
• GitHub: https://github.com/XPRNetwork
• Block Explorer: https://explorer.xprnetwork.org
• Discord: https://discord.gg/xprnetwork

License

MIT License - see LICENSE for details.

Built for the XPR Network community by developers, for developers.