agent-skills.md

Agent skills

Two skills set up and tune Adaptif from your coding agent. They work with Claude Code, Cursor, Codex, GitHub Copilot, and other agents.

Set up: adaptif-setup

npx skills add robiscoding/adaptif --skill adaptif-setup

Or, in Claude Code, from the plugin marketplace:

/plugin marketplace add robiscoding/adaptif
/plugin install adaptif@adaptif

Then ask your agent Set up Adaptif in this app. It reads your project and asks what UI you want to adapt, helps you write the first question, and picks the state it needs. Then it installs the packages, writes the config and the server route, wraps your current UI so it stays the fallback, and checks the build. It works with Next.js, and with Vite or React Router frontends on Express, Fastify, Koa, NestJS, Hono, Bun, Deno, or Cloudflare Workers.

Ask it to apply the closest recipe: a Pro upgrade prompt, a migration guide for someone comparing you with a tool they already use, or a help article chosen from the user's own words. The recipes, including the question text and two labeled sessions each, are in the recipe catalog.

The skill never asks for your API key. It adds an empty TYPESAFE_API_KEY= line for you to fill in. Until you do, the app renders as it does today. ?adaptif.force=<id> previews the new branch with no key and no model call. Checking the two labeled sessions is a separate step: two model calls, and the skill asks first.

Tune: adaptif-tuning

npx skills add robiscoding/adaptif --skill adaptif-tuning

Once questions are live, this skill helps when UI shows too early, too late, or for the wrong option, or when you want a predictable number of model calls. It reviews the state, events, guidance, gates, and rate limits; writes labeled test sessions with you; and checks them free first. It asks before every run that would call the model, and says how many calls the run will make.