Agent Skills Integration Guide
Agent Skills Integration Guide
This guide walks you through installing WAIaaS skill files using the Agent Skills open standard. This format is compatible with 27+ AI agent platforms.
What is Agent Skills?
Agent Skills is an open standard for AI agent capability files. Platforms that support it automatically discover .skill.md or SKILL.md files in designated directories and make them available to AI agents.
Supported Platforms
| Platform | Skills Directory | Status |
|---|---|---|
| OpenAI Codex | .agents/skills/ |
Supported |
| Gemini CLI | .agents/skills/ |
Supported |
| Goose | .agents/skills/ |
Supported |
| Amp | .agents/skills/ |
Supported |
| Roo Code | .agents/skills/ |
Supported |
| Cursor | .cursor/skills/ |
Supported (--target cursor) |
| GitHub Copilot | .github/skills/ |
Supported (--target github) |
| Claude Code | .claude/skills/ |
Use npx @waiaas/skills claude-code instead |
| OpenClaw | ~/.openclaw/skills/ |
Use npx @waiaas/skills openclaw instead |
Quick Setup
1. Initial Setup
If WAIaaS is not yet installed, follow the setup skill (waiaas-setup/SKILL.md) for CLI installation, daemon startup, wallet creation, and session configuration.
2. Install WAIaaS Skills
Default (Codex, Gemini CLI, Goose, Amp, Roo Code):
npx @waiaas/skills agent-skills
Installs to .agents/skills/waiaas-*/SKILL.md.
Cursor:
npx @waiaas/skills agent-skills --target cursor
Installs to .cursor/skills/waiaas-*/SKILL.md.
GitHub Copilot:
npx @waiaas/skills agent-skills --target github
Installs to .github/skills/waiaas-*/SKILL.md.
Available Skills
| Skill | Description |
|---|---|
waiaas-setup |
Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session |
waiaas-quickstart |
End-to-end quickset: create wallet, session, check balance, send first transfer |
waiaas-wallet |
Wallet CRUD, asset queries, session management, token registry, MCP provisioning |
waiaas-transactions |
All 5 transaction types (TRANSFER, TOKEN_TRANSFER, CONTRACT_CALL, APPROVE, BATCH) |
waiaas-policies |
Policy engine: 12 policy types for spending limits, whitelists, rate limits |
waiaas-admin |
Admin API: daemon status, kill switch, notifications, settings management |
waiaas-actions |
Action Provider framework: DeFi actions through the transaction pipeline |
waiaas-x402 |
x402 auto-payment protocol: fetch URLs with automatic cryptocurrency payments |
Dedicated Guides
For platform-specific setup with additional features:
- Agent Self-Setup: See Agent Self-Setup Guide -- fully autonomous setup with auto-provision
- Claude Code: See Claude Code Integration Guide -- includes MCP server integration
- OpenClaw: See OpenClaw Integration Guide -- includes
openclaw.jsonconfiguration
Updating Skills
To update to the latest skill files:
npx @waiaas/skills agent-skills --force
Troubleshooting
Skills not detected
Verify the skill files are in the correct directory for your platform:
# Default (Codex, Gemini CLI, Goose, Amp)
ls .agents/skills/waiaas-*/SKILL.md
# Cursor
ls .cursor/skills/waiaas-*/SKILL.md
# GitHub Copilot
ls .github/skills/waiaas-*/SKILL.md
Connection refused
Make sure the WAIaaS daemon is running:
curl http://localhost:3100/health
If not running:
waiaas start
Related
- Agent Self-Setup Guide - Autonomous daemon provisioning for agents
- API Reference - REST API that skills interact with
- Autonomous AI Agents Deserve Secure Wallets - Why agents need secure wallet access