CHINGDocs

Claude Code Skill

Integration

A drop-in Claude Code skill that teaches Claude how to integrate CHING into your SaaS. It loads automatically the moment Claude recognises a CHING-related task, so you can skip copy-pasting docs into every prompt. The same skill also installs into Cursor as a global rule.

Install with one command
Pulls the latest skill from github.com/ching-payments/skill and copies it into Claude Code (and Cursor, if installed).
npx @ching-payments/cli skill install

What it teaches Claude

  • The two golden rules: always use a hosted checkout session to subscribe, always use a setup session to save a card.
  • The right endpoint for each business goal - charges, subscriptions, refunds, billing portal, webhooks.
  • ILS amount conventions (agorot, never floats), test vs live keys, and the auth header format.
  • Full API reference for every endpoint with parameter shapes and response examples.

Install with the CLI

The CHING CLI ships an install command that downloads the latest skill straight from GitHub and places it where Claude Code (and Cursor) auto-discovers it. No zip to download, no folders to drag.

npx @ching-payments/cli skill install

The installer interactively asks two things:

  1. Where - globally (~/.claude/skills/, available in every project on this machine) or current project only (./.claude/skills/, shipped to teammates via git).
  2. Which AI tools - Claude Code, Cursor, or both. Tools the CLI can detect on your machine are pre-selected.

After install, restart Claude Code (or open a new chat) so the skill loads.

When the upstream skill changes, refresh your install with:

ching skill update              # asks: global vs current project

Skip the prompts in scripts:

ching skill install --global --target=claude --force
ching skill install --project --target=claude,cursor

ching skill update --global
ching skill list
ching skill uninstall --global

See the CLI reference for the full set of CHING CLI commands.

Manual install (fallback)

If you cannot run the CLI for some reason, the skill repo at github.com/ching-payments/skill is public. Clone it directly into Claude Code's skills folder:

mkdir -p ~/.claude/skills
git clone https://github.com/ching-payments/skill.git \
  ~/.claude/skills/ching-payments-integration

For project-level installs, drop it under .claude/skills/ at the root of your repo so teammates get it on next pull.

Use it

The skill activates on its own when you mention CHING, payments, subscriptions, checkout, or webhooks. You can also invoke it explicitly:

> Use the ching-payments-integration skill to add a "Subscribe" button to my Next.js app

Claude will follow the golden rules, pick the right endpoint, and produce code that uses your ck_test_ key by default.