S
/Docs

Skills Overview

Skills are reusable capability packages that extend what AI agents can do on Starknet. Each skill provides a focused set of tools, code examples, and documentation for a specific domain.

What are Skills?

A skill is a self-contained package defined by a SKILL.md file with:

  • YAML Frontmatter - Metadata like name, description, and keywords
  • Documentation - Detailed guides and code examples
  • Prerequisites - Required packages and environment variables
  • Reference Scripts - Working code snippets agents can use

Skill Format

Skills follow the AgentSkills specification - a standard format for defining AI agent capabilities that works across different frameworks and models.

Available Skills

Starknet Agentic provides twelve official skills:

SkillDescription
starknet-walletWallet management, transfers, balances
starknet-defiToken swaps, DCA, staking via AVNU
starknet-identityERC-8004 on-chain agent identity
starknet-mini-payP2P payments, Telegram bot
starknet-anonymous-walletPrivacy wallets via Typhoon
huginn-onboardBridge to Starknet + Huginn registration
starknet-jsstarknet.js v9.x SDK patterns and examples

Cairo Development Skills

The Cairo skill family provides comprehensive coverage for Cairo smart contract development:

SkillDescription
cairo-contractsContract structure, storage, events, OZ components
cairo-testingsnforge testing patterns, cheatcodes, fuzzing
cairo-securitySecurity patterns from 50+ audits
cairo-optimizationGas optimization, BoundedInt, storage packing
cairo-deployDeployment with sncast, verification, multicall
8 skills available

Wallet

starknet-wallet

Manage Starknet wallets with Account Abstraction. Transfer tokens, check balances, multi-call transactions, and gasless operations.

wallettransferbalancesession-keys+3
  • Balance checks
  • Token transfers
  • Multi-call batching

DeFi

starknet-defi

Execute DeFi operations via AVNU aggregator. Token swaps with best-price routing, DCA orders, STRK staking, and lending.

defiswapdcastaking+4
  • Token swaps
  • DCA orders
  • STRK staking

Identity

starknet-identity

Register AI agents on-chain using ERC-8004 Trustless Agents standard. Build reputation through feedback and validation.

identityerc-8004reputationvalidation+2
  • Agent registration
  • ERC-721 identity NFTs
  • Reputation system

Mini-Pay

starknet-mini-pay

Simple P2P payments on Starknet. Generate QR codes, create payment links, manage invoices. Like Lightning, but native.

paymentsqr-codepayment-linksp2p+2
  • QR code generation
  • Payment links
  • Invoice system

Anonymous Wallet

starknet-anonymous-wallet

Create privacy-preserving Starknet wallets via Typhoon. Break the on-chain link between deposits and agent operations.

anonymousprivacytyphoonwallet+1
  • Anonymous accounts
  • Typhoon integration
  • ABI discovery

Huginn Onboard

huginn-onboard

Bridge assets to Starknet and register with the Huginn thought provenance registry. Complete onboarding for verifiable AI agents.

huginnonboardingbridgeregistration+2
  • Asset bridging
  • Huginn registration
  • Thought logging

Cairo Coding

cairo-coding

Production-grade Cairo optimization patterns. Gas-efficient arithmetic, storage packing, BoundedInt limb assembly, and Poseidon hashing.

cairooptimizationgasbounded-int+3
  • Gas optimization rules
  • BoundedInt patterns
  • Storage packing

starknet.js SDK

starknet-js

Comprehensive guide for building Starknet dApps using starknet.js v9.x. Providers, accounts, contracts, multicall, paymaster, and SNIP-9/12.

starknet-jssdktypescriptaccount-abstraction+4
  • Provider setup
  • Account management
  • Contract interaction

Installing Skills

Skills are designed to be loaded by AI agents at runtime. The agent reads the skill documentation and uses the provided code patterns to accomplish tasks.

Uses the Vercel Skills CLI to install skills directly into your agent's context.

# Install all skills from the repo
npx skills add keep-starknet-strange/starknet-agentic

# Or install a specific skill
npx skills add keep-starknet-strange/starknet-agentic/skills/starknet-wallet

Method 2: Claude Code Plugins

/plugin install starknet-wallet@keep-starknet-strange-starknet-agentic

Method 3: Direct GitHub Clone

git clone https://github.com/keep-starknet-strange/starknet-agentic.git
cp -r starknet-agentic/skills ./skills

The agent will automatically discover skills in the skills/ directory.

For MCP Server Users

The MCP server provides tools that implement skill functionality directly. See the MCP Server Guide for setup.

Using ClawHub (Coming Soon)

Browse and install community skills from ClawHub:

# Install a skill from ClawHub
claw install starknet-wallet

Skill File Structure

Each skill follows this structure:

skills/
|
+-- starknet-wallet/
    |-- SKILL.md          # Skill definition (required)
    |-- package.json      # Dependencies (optional)
    |-- scripts/          # Reference implementations
    |   |-- check-balance.ts
    |   +-- transfer.ts
    +-- .env.example      # Environment template

SKILL.md Format

Every skill has a SKILL.md file with YAML frontmatter:

---
name: starknet-wallet
description: >
  Create and manage Starknet wallets for AI agents.
  Transfer tokens, check balances, and more.
keywords:
  - starknet
  - wallet
  - transfer
  - balance
allowed-tools:
  - Bash
  - Read
  - Write
user-invocable: true
---

# Starknet Wallet Skill

Documentation content here...

Frontmatter Fields

FieldRequiredDescription
nameYesLowercase, hyphenated identifier (1-64 chars)
descriptionYesMulti-line description of capabilities
keywordsYesArray of discovery keywords
allowed-toolsNoTools the skill can use
user-invocableNoWhether users can invoke directly

Using Skills in Agents

When an agent loads a skill, it gains access to:

  1. Code Examples - Copy-paste ready TypeScript/Python snippets
  2. Tool Definitions - MCP tool schemas and handlers
  3. Error Handling - Common errors and recovery strategies
  4. Configuration - Environment variables and setup

Load the Skill

The agent reads the SKILL.md file and extracts the relevant documentation.

Install Dependencies

If the skill requires packages, the agent runs the installation commands.

Configure Environment

Set up required environment variables from the skill's configuration section.

Execute Operations

The agent uses code examples as templates to accomplish the user's task.

Next Steps