Dev

The agent-native way to build on Andamio. Install the CLI, add the andamio-dev skills, and let an AI coding agent operate Andamio with you.

andamio-dev is a public Agent Skills package that pairs with the Andamio CLI so an AI coding agent can operate Andamio alongside you. It serves two purposes:

Operational skills for day-to-day development: API exploration, exact CLI commands, cost estimation, course and project operations, and troubleshooting.
The "Build on Andamio" course, a seven-module curriculum delivered by agent, with hands-on exercises and assignment assessment.

Use one or both. The ops skills work standalone and stay useful long after the course.

Prerequisites

A terminal with an AI coding agent (Claude Code, Cursor, or similar)
The Andamio CLI
Free test ADA from the Cardano preprod faucet

New to Cardano? Start with /orientation or /learn; both walk you through CLI install and faucet funding. Everything runs on the preprod testnet, so no real money is needed.

Full documentation

andamio-dev is open source, and the andamio-dev repo is the source of truth for the complete skill set, course content, and reference material. The rest of this page is a quick orientation.

The agent-native workflow

The CLI is built to be driven by an agent, not just typed by hand. The pattern James and the team use daily:

Install the Andamio CLI.
Add the andamio-dev skills package to your agent (install below).
Point your agent at both, then describe what you want in plain language.

With the commands and the guidance in its context, the agent can explore the Gateway API, look up the exact CLI command for any operation, estimate ADA costs, run full course and project lifecycles, and diagnose failures. You describe the outcome; the agent runs the transaction state machine.

Install

Claude Code plugin (recommended)

Add to your .claude/settings.json:

{
  "enabledPlugins": {
    "andamio-dev@andamio": true
  },
  "extraKnownMarketplaces": {
    "andamio": {
      "source": {
        "source": "github",
        "repo": "Andamio-Platform/andamio-marketplace"
      }
    }
  }
}

Clone

git clone https://github.com/Andamio-Platform/andamio-dev.git
cd andamio-dev

Built to the Agent Skills open standard. Developed and tested on Claude Code; it may work with any Agent Skills-compliant agent (Cursor, Gemini CLI, OpenAI Codex, and others). See SETUP.md for Windows, WSL, and Codex setup.

Where to start

Command	Use when
`/start`	You're not sure where to begin. It detects intent and routes you to the right skill.
`/orientation`	First time here. Take a 15-minute guided tour with hands-on exercises.
`/learn`	You want the full curriculum. Starts the "Build on Andamio" course.

Operational skills

Ten skills for day-to-day Andamio development. They work standalone, without the course.

Skill	Command	What it does
Orientation	`/orientation`	First-run walkthrough: a 15-minute guided tour with hands-on exercises.
Start	`/start`	Entry point. Detects intent, routes to the right skill.
Explore API	`/explore-api`	Search Gateway API endpoints by natural language.
CLI Guide	`/cli-guide`	Get exact CLI commands for any operation.
Auth Setup	`/auth-setup`	Walk through API key, wallet JWT, and environment config.
Cost Estimator	`/cost-estimator`	Calculate ADA costs for courses, projects, and user scenarios.
Course Ops	`/course-ops`	Course lifecycle: create, modules, teachers, content import.
Project Ops	`/project-ops`	Project lifecycle: create, tasks, contributors, treasury.
Troubleshoot	`/troubleshoot`	Debug API errors, CLI failures, and transaction rejections.
Compound	`/compound`	Extract patterns from sessions to improve future guidance.

The "Build on Andamio" course

Run /learn to start. An agent delivers each lesson, guides you through exercises, and runs CLI commands alongside you. When you finish a module, an assessor evaluates your assignment; pass, and the next module unlocks. 31 learning targets across 7 modules.

Module	Name	What you'll be able to do
100	Foundations	Explain Andamio's learning model, install the CLI, fund a wallet
200	Identity	Mint an access token, authenticate with API keys and JWTs
300	Reading Andamio	Query the Gateway API, navigate the OpenAPI spec
400	TX State Machine	Execute transactions, diagnose failures, handle edge cases
500	Courses End-to-End	Create and run a full course lifecycle on-chain
600	Projects End-to-End	Create and run a full project lifecycle with treasury
700	Build Something Real	Ship a working Andamio integration

The same curriculum is available as a live browser course at app.andamio.io, with on-chain progress and credential NFTs. You can mix the two: read a lesson in the app, then run /learn locally to do the exercise with an agent.