appcharge-skills

Appcharge Skills

Official Agent Skills library for Appcharge clients and partners. Skills teach AI coding agents how to work with the Appcharge platform — APIs, dashboards, integrations, and operational workflows.

Repository: github.com/Appcharge/appcharge-skills (public)

Works with Cursor, Claude Code, Codex, and other agents that support the Agent Skills standard.

Quick start

Install all skills into your project (recommended for app repos):

npx skills add Appcharge/appcharge-skills --agent cursor claude-code -y

Install globally (available in every project):

npx skills add Appcharge/appcharge-skills -g --agent cursor claude-code -y

List available skills without installing:

npx skills add Appcharge/appcharge-skills --list

Install a single skill:

npx skills add Appcharge/appcharge-skills --skill <skill-name> -y

After installing, start a new agent session so skills are picked up.

Available skills

Publisher callback endpoints (Go / Python)

These skills guide an agent to add Appcharge → publisher HTTP callbacks in a Go or Python backend. Each skill tells the agent to curl the official .md spec (request/response + signing) from docs.appcharge.com rather than duplicating contracts in this repo. Signing entry point: docs/callbacks/secure-communication.md.

Skill	Endpoint	Official spec (markdown)
grant-award-callback	Fulfill purchases and free offers; return publisherPurchaseId	grant-award-callback.md
personalize-webstore-callback	Sync player store UI, offers, balances, segments	personalize-webstore-callback.md
authenticate-player-callback	Validate web store login (SSO, password, OTP)	authenticate-player-callback.md
initiate-game-auth-callback	Start Game Redirect Login (deepLink + accessToken)	initiate-game-auth-callback.md

Install one callback skill:

npx skills add Appcharge/appcharge-skills --skill grant-award-callback -y

Typical web store flow:

initiate-game-auth-callback  →  (game)  →  authenticate-player-callback
        ↓ (optional)                              ↓
personalize-webstore-callback  ←──────── login / purchase / sync
        ↓
grant-award-callback  ←  checkout complete

Update skills

Refresh installed skills to the latest version from this repository:

npx skills update

Update only global or only project skills:

npx skills update -g    # global
npx skills update -p    # current project

Update one skill by name:

npx skills update <skill-name>

Other CLI commands

Command	Description
npx skills list	Show skills installed in the current project
npx skills ls -g	Show globally installed skills
npx skills remove <name>	Remove a skill
npx skills find <query>	Search skills.sh

Discover more community skills: skills.sh

Install by agent

Cursor

Option A — skills CLI (recommended)

npx skills add Appcharge/appcharge-skills --agent cursor -y

Skills are linked under .cursor/skills/ (or .agents/skills/). View them in Cursor Settings → Rules → Agent Decides.

Option B — remote rule from GitHub

1. Cursor Settings → Rules
2. Add Rule → Remote Rule (GitHub)
3. Repository: https://github.com/Appcharge/appcharge-skills

Claude Code

Option A — skills CLI

npx skills add Appcharge/appcharge-skills --agent claude-code -y

Option B — Claude plugin (from this repo)

/plugin marketplace add https://github.com/Appcharge/appcharge-skills
/plugin marketplace update
/plugin install appcharge-skills@appcharge-skills

Plugin skills are namespaced: /appcharge-skills:<skill-name>.

Repository layout

appcharge-skills/
├── docs/callbacks/              # Shared signature verification notes
└── skills/
    └── <skill-name>/
        ├── SKILL.md             # Required
        ├── scripts/             # Optional
        ├── references/          # Optional
        └── assets/              # Optional