Skills

Skills are markdown files that give AI coding tools deep knowledge about the Oviato SDK. Instead of configuring each tool separately, you install one skill and your AI assistant understands authentication, wallets, transactions, RPC, and all Oviato patterns.

Oviato Skill

The Oviato skill teaches your AI assistant the SDK's mental model, decision trees, recipes, and anti-patterns:

• Three API surfaces — chain-agnostic (sendTransfer, signMessage, switchNetwork, getBalance, auth), evm.* (reads, writes, tokens, NFTs, EIP-712, fees, receipts), utxo.* (PSBT signing)
• Two packages, one API — when to pick @oviato/sdk vs @oviato/connect, the exact import rules, why installing both is a foot-gun
• Decision trees — "which package?", "which surface for this task?", "popup or iframe?"
• Response envelope pattern — discriminated { status, type, data } returns, how to narrow, why cancellation isn't a thrown exception
• Nonce tracker — what it is, why you never manage nonces, how auto-release works on pre-mempool errors
• Recipes — connect + session, native send, ERC-20 transfer, approve + use, typed-data signing, PSBT signing, multicall
• Error-keyed troubleshooting — replacement underpriced, nonce too low, missing revert data, popup blocked, etc.
• Anti-patterns — explicit "don't do this" list (install both packages, EIP712Domain in types, parsing formatted for math, etc.)
• Scope limits — explicitly tells the agent what's NOT supported (ordinals/inscriptions, Solana, watchAsset, simulateContract) so it won't invent APIs

The skill also instructs the agent to fetch https://docs.oviato.com/llms-full.txt for anything not covered — so it stays accurate even after the SDK evolves.

View the Skill

You can view and download the full skill file here:

https://docs.oviato.com/skills/oviato.md

How to Use

Once installed, your AI assistant will automatically apply Oviato knowledge when you:

• Ask it to implement authentication, wallet features, or transactions
• Reference @oviato/connect / @oviato/sdk / evm.* / utxo.* in your code
• Ask about PSBT signing, contract calls, EIP-712, gas estimation, or RPC calls
• Migrate code from viem or ethers
• Need help debugging Oviato-related errors

You don't need to prompt it with any special commands — the skill is always active in your project.

Example Prompts

After installing the skill, try:

Set up Oviato authentication in my Next.js app with OviConnectProvider
and a connect button.

Add a "Send Bitcoin" button that calls sendTransfer when the user
clicks it. Show the txid on success.

I need to sign a PSBT hex string and broadcast it using the Oviato SDK.
Show me how to call signPsbt with broadcast enabled.

Fetch and display the user's wallet balance using the Oviato RPC client.

How to Install

Claude Code

Create the skill file in your project's .claude/skills/ directory:

mkdir -p .claude/skills/oviato
curl -o .claude/skills/oviato/SKILL.md https://docs.oviato.com/skills/oviato.md

Claude Code automatically reads skills from .claude/skills/ in your project. No additional configuration needed.

Cursor

Create a .cursor/rules/ directory and add the skill as a rule file:

mkdir -p .cursor/rules
curl -o .cursor/rules/oviato.mdc https://docs.oviato.com/skills/oviato.md

Cursor will automatically pick up rules from .cursor/rules/ and apply them as context.

Antigravity

Add the skill to your project's .agents/skills/ directory:

mkdir -p .agents/skills
curl -o .agents/skills/oviato.md https://docs.oviato.com/skills/oviato.md

Antigravity reads skills from .agents/skills/ at the workspace level. It also supports GEMINI.md and AGENTS.md at the project root for rules.

Codex

Add the skill to your repository's AGENTS.md or Codex setup instructions. Download the skill file and include its contents:

curl -o AGENTS.md https://docs.oviato.com/skills/oviato.md

Codex will read AGENTS.md from your repository root as project context.

Other Tools

For any AI coding tool that supports project-level context files:

1. Download the skill: oviato.md
2. Place it in your tool's context/rules directory
3. The AI will use it as persistent knowledge for your project

Keeping the Skill Updated

The skill file at https://docs.oviato.com/skills/oviato.md is kept in sync with the latest SDK releases. To update:

# Re-download to overwrite your local copy
curl -o .claude/skills/oviato/SKILL.md https://docs.oviato.com/skills/oviato.md

Replace the path with wherever you installed the skill for your tool.