---
name: Smart Glocal Skills
description: >-
  A collection of OpenCode-compatible skills for the Smart Glocal API.
  Each skill provides step-by-step instructions for AI assistants covering
  all scenarios: from setup to webhooks.
---

# Smart Glocal Skills

A set of skills for AI assistants (OpenCode, Claude, ChatGPT, and others) for working with the Smart Glocal API. Each skill is a `SKILL.md` file with YAML frontmatter (`name`, `description`) and structured LLM instructions.

## Contents

| Skill | Description |
|-------|-------------|
| `api-methods` | Shared methods: session/status, token, idempotency, errors, API versions |
| `delayed-capture` | Two-phase payment: hold + capture |
| `getting-started` | Access setup, RSA key generation, authentication, first request |
| `go-live-checklist` | Production cutover: credentials, environment switch, webhook config |
| `local-payments` | Local card payments by country, Pix, UPI, e-wallet |
| `one-time-payment` | One-time card payment with open parameters |
| `payment-widget` | Frontend widget integration for card data collection |
| `recurring` | Recurring payments (CIT + MIT), token management |
| `refunds` | Full and partial refunds, chargeback |
| `reports` | Daily payment and payout reports, reconciliation |
| `telegram-payments` | Payments via Telegram bot |
| `webhooks` | Handling all webhook types, signature verification, IP allowlisting |

## How to use in OpenCode

1. **Download the skills:** [smart-glocal-skills-v1.zip](https://developer.smart-glocal.com/assets/skills/smart-glocal-skills-v1.zip)
2. **Unzip** the archive into your project root
3. **Add to `opencode.json`:**
   ```json
   {
     "skills": {
       "paths": ["./skills"]
     }
   }
   ```
4. **Reload** OpenCode — skills will appear in the interface and apply automatically to relevant requests.

## How to use a single skill

Each skill is available at a direct URL:

```
https://developer.smart-glocal.com/assets/skills/<name>/SKILL.md
```

For example:
- `https://developer.smart-glocal.com/assets/skills/getting-started/SKILL.md`
- `https://developer.smart-glocal.com/assets/skills/one-time-payment/SKILL.md`

Open in a browser → copy the content → paste into your prompt.

## Skill format

Each skill is a Markdown file with mandatory YAML frontmatter:

```yaml
---
name: getting-started
description: Brief description with keywords to trigger the AI
---
```

The skill name (`name`) matches the folder name, is case-insensitive, and uses hyphens.

## Compatibility

- **OpenCode** — full support (frontmatter + paths)
- **Claude (Projects)** — paste contents into Project Knowledge
- **ChatGPT (GPTs)** — paste into instructions
- **Any AI** — works with any Markdown-capable assistant

## Building from source

Skills live in `static/assets/skills/` in the documentation repository. When Docusaurus builds, they are copied to `build/assets/skills/` and become available via URL.

To build the archive locally:

```bash
cd v2-website
node scripts/archive-skills.js
```

## Versioning

Current version: **v1**.

See the [changelog](https://developer.smart-glocal.com/changelog) for updates.