Stigg — Umbrella Skill

Stigg is a pricing, packaging, and entitlements platform. This skill is the first stop for any Stigg work. It enforces the search-first rule and routes you to the right sub-skill.

Step 0 — You Need a Stigg Account

Every other step assumes you already have:

1. An account at app.stigg.io (sign up if you don't).
2. At least one environment in that account (dev / staging / prod — Stigg provisions a default sandbox automatically; production environments are on the Scale plan).
3. An API key from Integrations → API keys in the environment you intend to operate on.

Without these three, every "set up Stigg" step in the sub-skills will fail with 401 Unauthenticated. Surface this to the user at the start of the integration if they haven't done it.

If the project uses Stripe Projects, skip the browser entirely — stripe projects add stigg/environment creates the account and environment and writes the keys into .env. Load stigg-sp.

The Search-First Rule (non-negotiable)

Before generating any Stigg integration code, search the live docs. Stigg ships rapidly; baked-in snippets go stale. The rule applies even when you "remember how it works."

For every Stigg task → search docs → then (if connected) call the Stigg MCP → only then write code.

How to search, ranked:

1. Stigg MCP server (mcp.stigg.io) — if the user has it connected, the agent can call search_docs and execute against the real environment. See stigg-mcp.
2. Mintlify Stigg docs MCP — if the agent has the official docs MCP available (searchstigg, querydocsfilesystemstigg), use it.
3. https://docs.stigg.io/llms.txt — LLM-friendly URL index. Fetch it, find the relevant page, fetch that page.
4. Direct fetch of docs.stigg.io/<path> — last resort.

Full rationale and examples: references/search-first.md.

Red flag — STOP and search: you're about to write import Stigg from '@stigg/...', a curl https://api.stigg.io/... call, or any GraphQL mutation, and you have not opened a docs page in this turn.

Pick the Right Surface

Stigg exposes several integration surfaces. Pick deliberately. Default to the MCP unless the user explicitly asks for the CLI — full posture in stigg-mcp/references/cli-vs-mcp.md.

Decision flowchart with edge cases: references/decision-tree.md. CLI vs MCP details: stigg-mcp/references/cli-vs-mcp.md.

Routing — Which Sub-Skill You Need

Sub-skill invocation is automatic. When the user's request matches a sub-skill's triggers (per the table below and each sub-skill's frontmatter description), invoke that sub-skill via the Skill tool immediately. Load it alongside this umbrella — they work together. Do not ask the user to run /stigg-<name>. Do not "route by mention." The user types their goal in plain English; this skill picks the right pillar and loads it.

The sub-skills (stigg-mcp, stigg-governance, …) are sibling directories of stigg/, not nested under it — skills/stigg/ and skills/stigg-governance/ sit side by side. Invoke them by name; don't look for them inside stigg/.

If a sub-skill exists for the task, invoke it via the Skill tool — do not improvise content from outside this repo, and do not stall waiting for the user to type its slash command.

Stigg in 60 Seconds

Minimum vocabulary before building. Full glossary: references/core-concepts.md.

• Customer holds Subscriptions to Plans under a Product. Subscriptions can include Add-ons.
• Features (boolean / configuration / metered) define what's gateable. Entitlements = feature + configured value (e.g. "10k API calls / month" on Pro).
• Promotional entitlements are per-customer overrides outside the subscription. Credit pools / grants / ledger power credit-based pricing — one pool per credit currency. See stigg-credits.
• Governance adds per-entity budgets (departments / teams / agents) on top of features and credits — account-gated, see stigg-governance.
• Environments (sandbox / staging / production) are isolated workspaces; each has its own API keys.

When NOT to Load This Skill

• The task is unrelated to Stigg (pricing/billing/entitlements).

Common Mistakes