Waffo Integrate

waffo-integrate

An AI coding skill for Codex, Claude Code, and Cursor that guides developers through integrating the [Waffo Payment SDK](https://github.com/waffo-com/waffo-sdk) into their projects and then verifying the integration end to end.

Changelog

See [CHANGELOG.md](./CHANGELOG.md) for release notes. GitHub Releases are also published for each `v*` tag.

Install

One command (npm)

# Auto-detect: installs to Codex, Claude Code, and/or Cursor if detected
npx @waffo/waffo-integrate

# Or specify target explicitly
npx @waffo/waffo-integrate --codex
npx @waffo/waffo-integrate --agents
npx @waffo/waffo-integrate --claude
npx @waffo/waffo-integrate --cursor

Codex

The npm installer now writes to the live Codex skill roots when they are present:

• ~/.agents/skills/waffo-integrate
• ~/.codex/skills/waffo-integrate
• ~/.Codex/skills/waffo-integrate

Claude Code only

claude /install-skill waffo-com/waffo-integrate

Cursor post-install

After running `npx @waffo/waffo-integrate --cursor`, add to your `.cursorrules` (or `.cursor/rules/waffo-integrate.mdc`):

When the user asks to integrate Waffo SDK, read and follow the instructions in .cursor/skills/waffo-integrate/SKILL.md.
Load reference files from .cursor/skills/waffo-integrate/references/ as directed by SKILL.md.

Manual (any AI coding assistant)

Copy `SKILL.md`, `references/`, `docs/`, and `bin/waffo-verify.js` into the same skill directory. For Claude Code enforcement, also copy `bin/waffo-claude-hook.js`. Point your AI assistant to read `SKILL.md` when integrating Waffo SDK.

What it does

A guided integration flow with Step 6 verification:

1. Detects language and project status — Node.js / Java / Go / Python / PHP; existing project or new scaffold
2. Selects features and context — payments, refunds, subscriptions, currency, and checkout decisions
3. Selects framework and events — Express, Spring Boot, Gin, FastAPI, plus deriv