tiun Skills

Agent Skills for building against the tiun SDK: auth and billing in one JS library (@tiun/sdk).

Installing

Works with any agent that supports the Agent Skills standard.

npx skills add tiun-app/skills

Requires Node.js 18+ (which provides npx) — Node 18 is past end-of-life, so a maintained LTS (20+) is recommended. The skills CLI figures out which agents you have installed and drops the skill in the right place.

Alternative methods

gh skill

Use the gh skill extension (preview):

gh skill install tiun-app/skills

Requires the GitHub CLI (gh) v2.90.0 or later. gh skill figures out which agents you have installed and drops the skill in the right place. Add --scope user to make it available across every project.

Claude Code

Install through the plugin marketplace:

/plugin marketplace add tiun-app/skills
/plugin install tiun-sdk@tiun-sdk

Cursor

Add manually via Settings > Rules > Add Rule > Remote Rule (Github) with tiun-app/skills.

Clone

If you'd rather wire it up by hand, clone and copy skills/tiun-sdk/ into your agent's skills directory:

| Agent | Skill directory | | ------------ | ------------------- | | Claude Code | ~/.claude/skills/ | | Cursor | ~/.cursor/skills/ | | OpenAI Codex | ~/.codex/skills/ | | Gemini CLI | ~/.gemini/skills/ |

Skills

| Skill | Useful for | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | tiun-sdk | Wiring up @tiun/sdk: subscription gating with userChange and productAccess, time-based paywalls with tiun.start() and paywallShow / paywallHide, hosted checkout/login, server-side verification, and framework setup for vanilla JS, React, Vue 3, Nuxt, Next.js, Svelte, Solid, Astro, Angular, and mobile WebViews. Includes a mandatory discovery step before generating code. |

The skill triggers automatically on imports of @tiun/sdk, calls like tiun.init / tiun.checkout, and questions about tiun products or entitlements.

MCP server

Install the tiun MCP server so agents can fetch your providers and products directly from your dashboard during integration. It backs the discovery step in tiun-sdk and gives agents live access to your account context (products, environments, sandbox state).

Universal config

{
  "mcpServers": {
    "tiun": {
      "type": "http",
      "url": "https://mcp.tiun.business"
    }
  }
}

Per client

Claude Code: the plugin marketplace install (/plugin install tiun-sdk@tiun-sdk) auto-wires the MCP via this repo's .mcp.json. To add manually: claude mcp add tiun https://mcp.tiun.business --transport http (verify the exact flag in your Claude Code version).
Cursor: Settings → MCP → Add new MCP server → paste the JSON block above. Or merge it into ~/.cursor/mcp.json.
OpenAI Codex / Gemini CLI / others: paste the universal config above into the client's MCP config file. See the client's MCP documentation for the exact path.

On first call, agents will prompt for authentication against my.tiun.business.

Updating

When tiun's SDK changes, the reference files under skills/tiun-sdk/references/ get refreshed against docs.tiun.io/llms-full.txt. Pull the latest with:

gh skill update tiun-app/skills

tiun-sdk

Summary

Install to Claude Code