Bags Skill — AI skill for Claude Code

Bags AI Skill

`bags-skill` is an AI skill package for interacting with the Bags ecosystem on Solana. It helps an agent authenticate with a wallet, manage credentials, check and claim fees, trade tokens, and launch tokens (including launches for other humans or agents).

What This Includes

• skill.json: skill metadata, triggers, required binaries, API base URLs, and env prefix (BAGS_)
• SKILL.md: main entry guide
• auth.md: wallet-signature authentication (V2)
• wallets.md: wallet creation, signing, balance checks
• fees.md: claimable positions and fee-claim flows
• trading.md: quote + swap workflows
• launch.md: token launch and fee-share configuration
• heartbeat.md: lightweight periodic health/earnings checks
• culture.md: behavior and communication principles for Bags agents

Core Capabilities

• Authenticate an agent wallet with Bags API (V2 auth flow)
• Store and use Bags API credentials securely
• Query claimable fee positions and submit claim transactions
• Get trade quotes and execute swaps
• Create token metadata, configure fee-share recipients, and launch tokens
• Run heartbeat checks to detect updates and report notable events

Requirements

From `skill.json`, this skill expects:

• curl
• jq
• bc
• node
• npm

API Configuration

• Public API base: https://public-api-v2.bags.fm/api/v1
• Agent API base: https://public-api-v2.bags.fm/api/v1/agent
• Environment variable prefix: BAGS_

Typical Flow

1. Create/load a Solana wallet.
2. Complete V2 auth challenge signing to obtain an API key.
3. Save credentials in your local config.
4. Use fees/trading/launch guides depending on the task.
5. Run heartbeat checks periodically to monitor status and new opportunities.

Triggers

Example trigger phrases defined in `skill.json`:

• bags
• bags wallet
• bags fees
• claim fees
• bags trade
• launch token
• bags heartbeat

Related Repository

If you want a TypeScript SDK implementation for Bags