Skip to content

CLAUDE.md

Latest commit

 

History

History
95 lines (67 loc) · 4.33 KB

CLAUDE.md

File metadata and controls

95 lines (67 loc) · 4.33 KB

Bitrefill Skills — Agent Guide

Instructions:

  • Be semantically dense and token efficient. Prefer concise, information-rich responses; avoid filler, repetition, and unnecessary elaboration.
  • Whene editing, never mention the previous version or the changes you made. All the contents must be authoritative and up to date.
  • Try abstracting instructions that can be applied to multiple cases
  • Avoid creating new sections as much as possible. Try updating exisiting knowledge instead.

This repository is a monorepo of agent skills for Bitrefill, packaged as a Claude Code / Cowork plugin marketplace. Skills live in the skills/ directory and are distributed through the plugin system shared by Claude Code and Claude Cowork.

Installing the Plugin

Claude Code

Add the marketplace and install the plugin:

/plugin marketplace add bitrefill/agents
/plugin install bitrefill@bitrefill-skills

Claude Cowork

Cowork uses the same plugin system as Claude Code. Install through the Cowork plugin settings UI, or from a Cowork conversation:

  1. Open Settings > Plugins
  2. Add the marketplace source bitrefill/agents
  3. Install the bitrefill plugin

Once installed, Claude gains the bitrefill skill and the bundled eCommerce MCP connector (.mcp.json at plugin root, OAuth-only) — the skill routes the host to its highest-fidelity channel (residential browser, MCP, npm CLI, or REST API) for browsing or buying gift cards, mobile top-ups, and eSIMs; MCP tools start with the plugin enabled and prompt for OAuth on first call. Includes a dedicated OpenClaw integration guide for chat-channel scenarios (Telegram purchases, cron auto-renewals, mobile-camera context).

The skill activates automatically when Claude detects a relevant task (Bitrefill, gift cards, top-up, eSIM, crypto/Lightning/USDC/x402 checkout).

Local Testing

Load the plugin directly without installing from a marketplace:

claude --plugin-dir ./

Repository Structure

.claude-plugin/
  plugin.json          # Plugin manifest (name, version, author)
  marketplace.json     # Marketplace catalog listing the plugin
.mcp.json              # Optional — MCP server definitions (eCommerce HTTP MCP for this repo)
skills/
  <skill-name>/
    SKILL.md            # Required — frontmatter + agent instructions
    references/         # Optional — supporting docs, examples

The marketplace (marketplace.json) lists plugins available for installation. The plugin manifest (plugin.json) defines the plugin's identity. Skills inside skills/ are auto-discovered when the plugin loads. MCP servers in .mcp.json start when the plugin is enabled.

Adding a New Skill

  1. Create a directory: skills/<skill-name>/
  2. Add SKILL.md with YAML frontmatter: 
    ---
name: skill-name
description: Short description of what this skill does (max 1024 chars)
---
  3. Write agent instructions in the Markdown body (step-by-step, under 500 lines)
  4. Optionally add references/ with detailed documentation
  5. Bump the version in both plugin.json and marketplace.json

Naming Conventions

  • Skill names: lowercase, hyphens only (e.g., bitrefill, bitrefill-affiliate)
  • Directory name must match the name field in SKILL.md frontmatter
  • Reserved words anthropic and claude cannot appear in skill names (agentskills.io)

Publishing Updates

After modifying skills, bump the version field in .claude-plugin/plugin.json (and optionally in marketplace.json). Users with auto-update enabled receive changes at next Claude Code startup; others run:

/plugin marketplace update bitrefill-skills

Submitting to the Official Anthropic Directory

To make the plugin available in the official Claude plugin directory (visible in both Claude Code and Cowork), submit via one of:

Specification