> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent Skills
## What are agent skills?
Agent skills are bundles of domain knowledge that you install into your AI coding assistant. Where the [MCP server](/api-and-sdks/mcp-server) gives the agent API tools to act on your Stigg environment, skills give it the expertise to use those tools well — the right patterns, the right terminology, the right sequence of calls, and guardrails for common mistakes.
Think of it as pairing with a Stigg expert. When you ask Claude Code to "set up a credit system where users buy packs of 1,000 credits and each AI generation costs 10 credits" the skills tell it how Stigg's pricing model works, which features to create, how to structure the charges, and which SDK calls to make — so you get production-ready output instead of generic scaffolding.
**Skills work at the prompt layer.** They inject Stigg-specific knowledge into the agent's context so it can reason about your integration correctly. They don't make API calls themselves — that's what the MCP server is for. Together, they cover the full loop: know what to do, then do it.
***
## Install
**Skip the manual steps:** the [AI Terminal](/api-and-sdks/ai-terminal) installs these skills (and connects the [MCP server](/api-and-sdks/mcp-server)) in one command: `npx @stigg/terminal`.
The skills ship as a Claude Code plugin via Stigg's marketplace. Run these two slash commands separately inside a Claude Code session:
```bash Claude Code session theme={null}
/plugin marketplace add stiggio/skills
```
```bash Claude Code session theme={null}
/plugin install stigg@stigg-marketplace
```
Once installed, Claude Code auto-discovers every skill. The umbrella `stigg` skill acts as the entry point and routes to the right pillar automatically — you don't need to invoke individual skills by name.
Pair with the [MCP server](/api-and-sdks/mcp-server) so Claude Code can act on your Stigg environment directly. The skills cover what to do; the MCP server covers how to do it via live API calls.
Claude Desktop and Claude.ai don't read files installed by the `npx` CLI — skills must be uploaded directly.
1. [**Download skills (.zip)**](https://github.com/stiggio/skills/releases/)
2. In Claude: **Settings → Capabilities → Skills → Upload a skill** (code execution must be enabled).
***
## Available skills
There are 11 skills in total. You don't need to invoke them individually — once installed, the `stigg` umbrella skill routes every request to the right pillar.
| Skill | What it covers |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `stigg` | Entry point. Routes to the right skill, enforces the search-first rule, and provides the Stigg core-concepts glossary |
| `stigg-mcp` | Connecting the MCP server to Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, or Codex |
| `stigg-api` | Authentication, REST vs GraphQL, SDK selection, rate limits, pagination, idempotency |
| `stigg-pricing-modeling` | Modeling the catalog — features, plans, add-ons, charges, coupons, custom credit currencies, price localization |
| `stigg-entitlements` | Runtime gating, raw-events vs calculated-usage, cache and fallback strategy, promotional entitlements |
| `stigg-subscriptions` | Full subscription lifecycle — provision, preview, update, cancel, trials, multi-active subscriptions, plan-version migration |
| `stigg-credits` | Credit currencies, grants, ledger, consumption logic, custom formulas, auto-recharge, seat-based pools, billing integration |
| `stigg-widgets` | Drop-in UI — paywall, customer portal, checkout, credit widgets — using the live Storybook index |
| `stigg-webhooks` | Receiving Stigg events — signature verification, payload envelope, retry semantics, idempotency, handler skeleton |
| `stigg-pricing-expert` | Advisory — picks the right monetization model and hands off to implementation skills |
| `stigg-recipes` | End-to-end workflows — freemium, checkout, hybrid pricing, AI-credits monetization, trial with add-ons, payment links |
Install these skills and connect the MCP server in one command.
Connect Claude Code, Cursor, ChatGPT, and others to your live Stigg environment.
Provision customers, manage subscriptions, and report usage from the terminal.
***
## Example use-cases
### Design and build a pricing model
> *"I'm building an AI coding assistant. We want a freemium model — a free tier with a credit grant each month, a Pro tier with a larger monthly credit grant, and an Enterprise tier that's seat-based with a shared credit pool. Create the plans in Stigg."*
The `stigg-pricing-expert` skill picks the right model for your product type. The `stigg-pricing-modeling` skill handles the catalog structure — features, plans, charges, and entitlements. The `stigg-mcp` skill connects to your environment so the agent can create everything directly.
***
### Gate features by plan
> *"Add entitlement checks to our codebase. Pro users get 500 AI completions per month, Enterprise gets unlimited. If a user hits their limit, show a paywall."*
The `stigg-entitlements` skill knows how to structure the feature check, which SDK method to use, how to handle the fallback when Stigg is unavailable, and how to wire up the paywall trigger. The agent writes gating code that matches Stigg's recommended patterns rather than improvising.
***
### Set up credit-based monetization for an AI product
> *"Our AI product charges users per generation. Set up a credit system where users buy packs of 1,000 credits, each generation costs 10 credits, and we auto-recharge when they run low."*
The `stigg-credits` skill covers the full credits lifecycle: defining the credit currency, configuring grants and pricing, setting up auto-recharge thresholds, and wiring consumption to usage reporting. This is one of Stigg's more complex areas — the skill ensures the agent doesn't miss steps.
***
### Integrate drop-in UI widgets
> *"Add a pricing table to our marketing page, a paywall when users hit feature limits, and a self-serve customer portal where users can upgrade their plan."*
The `stigg-widgets` skill knows the full widget catalog, the props each component accepts, and how to theme them. It references the live Storybook index so the agent uses the current API rather than outdated examples.
***
### Handle subscription lifecycle events
> *"Write a webhook handler for subscription events — new subscriptions, upgrades, downgrades, and cancellations. I need to sync these to our database and send confirmation emails."*
The `stigg-webhooks` skill covers signature verification, payload structure, retry semantics, and idempotency. The agent produces a handler skeleton that's correct from the start, not one that will fail silently on duplicate deliveries.
***
### Migrate between pricing versions
> *"We're adding a new Enterprise tier. Walk me through rolling it out to existing customers — who gets migrated, who stays on legacy pricing, and how do we handle the billing transition."*
The `stigg-subscriptions` skill covers plan-version migration, the `stigg-pricing-expert` skill advises on the rollout strategy, and the `stigg-recipes` skill provides the composed workflow for a pricing change launch.