Agent Skills for Flare Development
About · Contributing · Security · Changelog

Flare AI Skills

A collection of Agent Skills for Cursor, Claude Code, and other skills.sh-compatible agents. Provides domain knowledge and guidance for Flare development, including FTSO, FAssets, Smart Accounts, and more. Same SKILL.md format works across tools.

Available Skills

Skill	Description
flare-general	General Flare knowledge—what Flare is, core protocols, networks, chain IDs, RPC endpoints, explorers, faucets, EVM setup, and developer tooling
flare-ftso	FTSO—decentralized block-latency price feeds (~1.8s), Scaling anchor feeds, feed IDs, onchain and offchain consumption, fee calculation, delegation
flare-fassets	FAssets—wrapped tokens (FXRP, FBTC, FDOGE), minting, redemption, agents, collateral, and smart contract integration
flare-fdc	Flare Data Connector—attestation types (EVMTransaction, Web2Json, Payment, etc.), request flow, Merkle proofs, verifier/DA Layer, contract verification
flare-smart-accounts	Smart Accounts—account abstraction for XRPL users to interact with Flare without owning FLR

What's in the skills

flare-general

• Flare overview: Interoperable EVM L1, enshrined protocols, fast finality (~1.8s), Snowman++ consensus
• Networks: Flare Mainnet (14), Coston2 (114), Songbird (19), Coston (16) — chain IDs, RPC URLs, explorers, faucets
• Core protocols: FTSO, FDC, FAssets, Smart Accounts — what each does and when to use a more specific skill
• Developer tooling: Hardhat/Foundry setup, ContractRegistry pattern, EVM version (cancun), key npm packages
• Wagmi/viem: @flarenetwork/flare-wagmi-periphery-package for typed contract interactions

flare-ftso

• FTSO overview: Enshrined oracle, block-latency feeds (~1.8s), ~100 data providers, stake-weighted VRF selection
• Architecture: Verifiably random selection, incremental delta updates, volatility incentive mechanism, Scaling anchoring
• Feed consumption: FtsoV2Interface (getFeedById, getFeedsById, wei variants), ContractRegistry resolution, FeeCalculator
• Scaling: Commit-reveal anchor feeds (90s), weighted median, Merkle tree finalization, incentivization
• Offchain reads: Web3.js/ethers scripts via RPC, @flarenetwork/flare-periphery-contract-artifacts for ABI

flare-fassets

• FAssets overview: Trustless bridge, FTSO/FDC, collateral model
• Participants: Agents, users, collateral providers, liquidators, challengers
• Workflows: Minting (reserve → pay → FDC proof → execute) and redemption; Core Vault
• Contracts: Runtime contract resolution via FlareContractsRegistry

flare-fdc

• Attestation types: AddressValidity, EVMTransaction, Web2Json, Payment, and FAssets-oriented types
• Workflow: Prepare request (verifier) → submit to FdcHub → round finalization → fetch proof from DA Layer → verify in contract
• Contract pattern: FdcVerification (ContractRegistry), verify then decode; Hardhat/Foundry starter examples (fdcExample, weatherInsurance, proofOfReserves)

flare-smart-accounts

• Account abstraction: XRPL users interact with Flare without owning FLR
• Instruction types: FXRP, Firelight, Upshift, and custom instructions
• CLI tool: Python CLI for encoding and sending XRPL transactions
• TypeScript integration: Viem-based examples for state lookup and custom instructions

The agent uses these skills when you work with FTSO price feeds, FAssets, FXRP, minting/redemption, FDC attestations, Smart Accounts, or Flare DeFi.

How to Use These Skills

How to install in Cursor

Method 1: Using skills.sh (recommended)

From your project or any directory, run:

# Install one or more skills (Cursor will use them when skills are enabled)
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-general
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-ftso
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fassets
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fdc
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-smart-accounts

See skills.sh for details. Ensure Cursor has skills enabled.

Method 2: Manual install

1. Clone or download this repo.
2. Copy or symlink the skill folders into Cursor’s skills directory:
   • This project only: ./.cursor/skills/
   • All your projects: ~/.cursor/skills/ (create the folder if it doesn’t exist)
3. Put each skill’s folder (e.g. flare-ftso-skill) inside that skills/ directory so Cursor sees the SKILL.md files.

Example for project-only install:

mkdir -p .cursor/skills
cp -r /path/to/flare-ai-skills/skills/flare-ftso-skill .cursor/skills/
cp -r /path/to/flare-ai-skills/skills/flare-fassets-skill .cursor/skills/
# repeat for flare-fdc-skill, flare-smart-accounts-skill

4. In Cursor, confirm skills are enabled (Settings → Cursor Settings → Rules for AI / Skills). You can then ask the agent to use a skill by name (e.g. “Use the flare-ftso skill and show how to read FTSO feeds”).

Option A: Using skills.sh (all compatible agents)

Install skills with a single command:

# Install General skill
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-general

# Install FTSO skill
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-ftso

# Install FAssets skill
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fassets

# Install FDC skill
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fdc

# Install Smart Accounts skill
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-smart-accounts

For more information, visit the skills.sh platform page.

Then use the skills in your AI agent, for example:

Use the flare-general skill and explain how to set up a Hardhat project for Flare development.

Use the flare-ftso skill and show how to consume FTSO price feeds in a Solidity contract.

Use the flare-fassets skill and explain how to mint FXRP step by step.

Use the flare-fdc skill and show how to request an EVMTransaction attestation and verify it in a contract.

Use the flare-smart-accounts skill and show how to send a custom instruction from XRPL to Flare.

Option B: Claude Code Plugin

Personal Usage

To install skills for your personal use in Claude Code:

1. Add the marketplace:

   /plugin marketplace add flare-foundation/flare-ai-skills
   

2. Install the skills:

   /plugin install flare-general@flare-ai-skills
   /plugin install flare-ftso@flare-ai-skills
   /plugin install flare-fassets@flare-ai-skills
   /plugin install flare-fdc@flare-ai-skills
   /plugin install flare-smart-accounts@flare-ai-skills
   

3. Manage plugins: Run /plugin to open the interactive plugin manager

Project Configuration

To automatically provide these skills to everyone working in a repository, configure the repository's .claude/settings.json:

{
  "enabledPlugins": {
    "flare-general@flare-ai-skills": true,
    "flare-ftso@flare-ai-skills": true,
    "flare-fassets@flare-ai-skills": true,
    "flare-fdc@flare-ai-skills": true,
    "flare-smart-accounts@flare-ai-skills": true
  },
  "extraKnownMarketplaces": {
    "flare-ai-skills": {
      "source": {
        "source": "github",
        "repo": "flare-foundation/flare-ai-skills"
      }
    }
  }
}

When team members open the project, Claude Code will prompt them to install the skills.

Plugin Architecture

This repository serves as both a skill collection and a Claude Code marketplace. The structure:

flare-ai-skills/
├── .claude-plugin/
│   └── marketplace.json    # Marketplace catalog listing all plugins
└── skills/
    ├── flare-general-skill/
    │   └── SKILL.md
    ├── flare-ftso-skill/
    │   └── SKILL.md
    ├── flare-fassets-skill/
    │   └── SKILL.md
    ├── flare-fdc-skill/
    │   └── SKILL.md
    └── flare-smart-accounts-skill/
        └── SKILL.md

The marketplace.json defines the marketplace name (flare-ai-skills) and lists each plugin with its source path. Users reference plugins as plugin-name@marketplace-name.

How to update skills

To update installed skills to the latest version, run:

npx skills update

This updates all installed skills. To update a specific skill only, reinstall it:

npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-general
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-ftso
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fassets
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-fdc
npx skills add https://github.com/flare-foundation/flare-ai-skills --skill flare-smart-accounts

Option C: Manual install

1. Clone this repository.
2. Install or symlink the desired skill folder(s) following your tool's official skills installation docs (see links below):
   • skills/flare-general-skill/ for general Flare knowledge
   • skills/flare-ftso-skill/ for FTSO
   • skills/flare-fassets-skill/ for FAssets
   • skills/flare-fdc-skill/ for FDC
   • skills/flare-smart-accounts-skill/ for Smart Accounts
3. Use your AI tool as usual and ask it to use the appropriate skill.

Where to Save Skills

Follow your tool's official documentation; here are a few popular ones:

• Codex: Agent Skills
• Claude Code: Extend Claude with Skills
• Cursor: Enabling Skills (or .cursor/skills/ in your project / ~/.cursor/skills/ for all projects)

How to verify

Your agent should reference the workflow and concepts from the skill's SKILL.md and use reference.md for Flare Developer Hub links when you ask about FTSO price feeds, FAssets, FXRP, minting, redemption, FDC attestations, Smart Accounts, or related topics.

Repository layout

flare-ai-skills/
├── README.md                        # This file
├── LICENSE                          # MIT
├── .gitignore
└── skills/
 ├── flare-general-skill/         # General Flare knowledge skill
 │   ├── SKILL.md                 # Main skill instructions
 │   └── reference.md             # Flare Developer Hub links
 ├── flare-ftso-skill/            # FTSO skill
 │   ├── SKILL.md                 # Main skill instructions
 │   ├── reference.md             # Flare Developer Hub links
 │   └── scripts/                 # Example scripts
 │       ├── consume-feeds.sol
 │       ├── verify-anchor-feed.sol
 │       ├── read-feeds-offchain.ts
 │       └── make-volatility-incentive.ts
 ├── flare-fassets-skill/         # FAssets skill
 │   ├── SKILL.md                 # Main skill instructions
 │   ├── reference.md             # Flare Developer Hub links
 │   └── scripts/
 │       └── get-fxrp-address.ts  # Utility: get FXRP address at runtime
 ├── flare-fdc-skill/             # FDC skill
 │   ├── SKILL.md                 # Main skill instructions
 │   └── reference.md             # Flare Developer Hub links
 └── flare-smart-accounts-skill/  # Smart Accounts skill
     ├── SKILL.md                 # Main skill instructions
     └── reference.md             # Flare Developer Hub links

Each skill folder (with SKILL.md and reference.md) can be installed independently into the tool's skills path.

Requirements

• Cursor: Cursor with Agent/Skills support
• Claude Code: Node.js 18+, npm install -g @anthropic-ai/claude-code, then run claude in your project
• Skill content is markdown only. Optional helper script scripts/get-fxrp-address.ts requires Node.js tooling (ethers, and either ts-node or Hardhat).

Links

• Install via skills.sh — one-command install for Cursor, Claude Code, Codex, and more
• Flare Developer Hub
• Flare Network Overview
• Flare FTSO Overview
• Flare FAssets Overview
• Flare FDC Overview
• Flare Smart Accounts Overview
• Flare Developer Hub
• Flare Network

License

MIT — see LICENSE.