pluggy-payments — Claude Code skill: PIX and Boleto payments
A skill for payment initiation through Pluggy: PIX, Boleto, Smart Transfers and scheduled charges. Useful when you need to wire a payment flow from request to webhook.
npx skills add pluggyai/agent-skills --skill pluggy-payments -a claude-codeWhat pluggy-payments does
Five rule categories ranked by priority: PIX integration, Smart Transfers, payment lifecycle, Boleto management and scheduled payments. Each category has a prefix — pix-, smart-, payment-, boleto-, schedule-. Rule files live in rules/, for example rules/pix-initiation.md and rules/smart-preauthorization.md.
Every file follows the same shape: a short note on why it matters, a wrong code example with an explanation, a correct one, and Pluggy-specific notes. The full compiled guide sits in AGENTS.md. The flow it describes: create a payment request with recipient details, create a payment intent for a specific Item, let the user authorize in the Connect Widget, then watch the status through a webhook and handle success or failure.
The skill ships no API calls of its own — it sets the order of steps and the mistakes people make. If you already have a working Pluggy integration and your own payment flow, the Smart Transfers and PIX Automático sections are where you will get the most.
What it helps with
- run a PIX payment from request creation to confirmation
- set up a Smart Transfer with preauthorization
- walk through the payment intent lifecycle
- issue and manage Boletos
- schedule a deferred payment with PIX Agendado
Example prompts for the agent
- help me implement a PIX payment through Pluggy, from payment request to webhook
- show me how to set up a Smart Transfer with preauthorization
- walk me through the payment intent lifecycle and where it typically breaks
How to install pluggy-payments
1Skills CLI (Vercel)
npx skills add pluggyai/agent-skills --skill pluggy-payments -a claude-code2Manually: put the files in place
~/.claude/skills/pluggy-payments/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pluggy-payments/
1Skills CLI (Vercel)
npx skills add pluggyai/agent-skills --skill pluggy-payments -a codex2Manually: put the files in place
.agents/skills/pluggy-payments/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pluggyai/agent-skills --skill pluggy-payments -a cursor2Manually: put the files in place
.cursor/skills/pluggy-payments/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pluggyai/agent-skills pluggy-payments2Manually: put the files in place
.github/skills/pluggy-payments/SKILL.md1Skills CLI (Vercel)
npx skills add pluggyai/agent-skills --skill pluggy-payments -a gemini-cli2Platform CLI
gemini skills install https://github.com/pluggyai/agent-skills --path skills/pluggy-paymentsManually: put the files in place
.devin/skills/pluggy-payments/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pluggyai/agent-skills --skill pluggy-payments -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pluggy-payments
How do I install pluggy-payments in Claude?
Run npx skills add pluggyai/agent-skills --skill pluggy-payments -a claude-code. The skill lands in ~/.claude/skills/pluggy-payments/SKILL.md.
What does pluggy-payments do?
It collects rules for payment initiation through Pluggy: PIX, Boleto, Smart Transfers, scheduled payments and PIX Automático. Each rule comes with wrong and correct code examples.
Which platforms does the skill support?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each has its own install command.
Source text
SKILL.md · MIT
--- name: pluggy-payments description: Payment initiation with PIX, Boleto, and Smart Transfers. Use when implementing payment flows, PIX transfers, or preauthorized payments. license: MIT metadata: author: pluggy version: "1.0.0" --- # Pluggy Payments Comprehensive guide for implementing payment initiation through Pluggy. Contains rules across 5 categories, prioritized by impact. ## When to Apply Reference these guidelines when: - Initiating PIX payments - Creating and managing Boletos - Setting up Smart Transfers with preauthorization - Managing payment intents lifecycle - Handling scheduled payments (PIX Agendado) - Implementing PIX Automático ## Rule Categories by Priority | Priority | Category | Impact | Prefix | | -------- | ------------------- | -------- | ------------ | | 1 | PIX Integration | CRITICAL | `pix-` | | 2 | Smart Transfers | HIGH | `smart-` | | 3 | Payment Lifecycle | HIGH | `payment-` | | 4 | Boleto Management | MEDIUM | `boleto-` | | 5 | Scheduled Payments | MEDIUM | `schedule-` | ## How to Use Read individual rule files for detailed explanations and code examples: ``` rules/pix-initiation.md rules/smart-preauthorization.md rules/payment-lifecycle.md ``` Each rule file contains: - Brief explanation of why it matters - Incorrect code example with explanation - Correct code example with explanation - Additional context and references - Pluggy-specific notes ## Payment Flow Overview ``` 1. Create Payment Request (with recipient details) 2. Create Payment Intent (for specific Item/account) 3. User authorizes in Connect Widget 4. Monitor payment status via webhook 5. Handle success/failure ``` ## Full Compiled Document For the complete guide with all rules expanded: `AGENTS.md`
© pluggy · MIT · pluggyai/agent-skills
