@island-pitch/ip-bot-skills

An installable Claude Code / Agent Skill that teaches an AI agent everything it needs to run IP Bot Powers and to spend & acquire Winds — the prepaid currency that pays for Power runs.

Once installed, an agent can, with no other docs:

• discover the 15 Powers and their Winds costs (listPowers),
• check a Winds balance (getWindsBalance),
• run a Power and read its result (executePower),
• handle INSUFFICIENT_WINDS / PAID_ONLY / UNKNOWN_POWER,
• top up Winds via Stripe (createWindsTopupSession),
• chain content Powers through the review → schedule → publish pipeline,
• and manage AutoReply campaigns (Instagram comment/DM automation with keyword + media-ID trigger scoping) within Meta's messaging rules — one private reply per comment, 7-day private-reply window, 24h DM window,

driving all of it through the ipbot CLI or the IP Bot MCP server.

What's in the skill

ip-bot-powers/
  SKILL.md                     # frontmatter + the agent-facing guide
  reference/
    powers-catalog.md          # every Power: id, cost, paid-only, connectors
    winds-economy.md           # tiers, refill, spend order, top-ups, refunds
    cli-and-mcp.md             # CLI commands + MCP tools, copy-paste examples

Install

1. npx (recommended)

Install into the current project's .claude/skills/:

npx @island-pitch/ip-bot-skills

Install user-wide into ~/.claude/skills/:

npx @island-pitch/ip-bot-skills --global

The installer is dependency-free and idempotent — re-run it any time to update.

2. Manual copy

mkdir -p .claude/skills/ip-bot-powers
cp -R SKILL.md reference .claude/skills/ip-bot-powers/
# or user-wide:  ~/.claude/skills/ip-bot-powers/

3. Docs

Read the guide directly: SKILL.md and the reference/ files. Full IP Bot docs: https://islandpitch.world/docs

After installing

Claude Code / the Agent runtime auto-discovers skills under .claude/skills/. The skill activates when a task involves running Powers or managing Winds.

Set the agent's auth before it runs Powers:

export IPBOT_APPSYNC_ENDPOINT="https://api.islandpitch.bot/graphql"
export IPBOT_API_KEY="ipbot_live_..."   # per-user key; resolves to its owner — no user id needed