Documentation

Install AISDK Agents skills

Install, verify, and update paid AISDK Agents skills with short-lived Skills CLI commands.

AISDK Agents skills are paid knowledge packages for AI coding assistants. The catalog currently includes:

  • aisdkagents: the agent-pattern playbook available to Premium individual and Premium team members.
  • build-ai-sdk-agent-evals: the Premium workflow for turning an existing AI SDK agent into an executable behavioral contract.
  • optimize-ai-sdk-agent: the Premium evidence loop for improving an existing AI SDK agent's quality, speed, cost, typing, and reliability without behavior regression.
  • plan-ai-sdk-agent: the Premium blueprint workflow for choosing the smallest viable architecture and mapping complete implementation contracts to installable AISDK Agents patterns.

Skills do not install paid Pattern source code. Each artifact contains its own SKILL.md, interface metadata when provided, and the runtime references named by that Skill.

Generate an install command

Open the protected install page for the skill and generate a fresh command:

pnpm dlx skills add https://aisdkagents.com/skill/<short-lived-token> --skill <skill-name>

The token is bound to one allowlisted skill and expires after the response's stated window. Generate a new command after expiry; a token for one skill cannot download another.

Preview and install

Use the tokenized URL from the generated command:

pnpm dlx skills add <tokenized-url> --list
npx skills add <tokenized-url> --skill build-ai-sdk-agent-evals
npx skills add <tokenized-url> --skill optimize-ai-sdk-agent
npx skills add <tokenized-url> --skill plan-ai-sdk-agent

The first command lists the skill available in the downloaded artifact. The second installs only the named skill and lets the current Skills CLI choose supported coding-agent targets.

Run the command from a repository root for a project-scoped install. Project scope is recommended when a team wants versioned, shared behavior. Add -g for a user-level install across local projects:

pnpm dlx skills add <tokenized-url> --skill build-ai-sdk-agent-evals -g
npx skills add <tokenized-url> --skill optimize-ai-sdk-agent -g
npx skills add <tokenized-url> --skill plan-ai-sdk-agent -g

Use an isolated home/config target for automated global smoke tests so existing personal skills remain untouched.

Verify and update

List installed skills:

pnpm dlx skills list

Check update status by skill name:

pnpm dlx skills update build-ai-sdk-agent-evals
npx skills update optimize-ai-sdk-agent
npx skills update plan-ai-sdk-agent

Skills CLI 1.5.16 reports that well-known URL skills cannot be checked automatically. Generate a fresh tokenized command from the protected page and rerun skills add to refresh the installed files:

pnpm dlx skills add <fresh-tokenized-url> --skill build-ai-sdk-agent-evals
npx skills add <fresh-tokenized-url> --skill optimize-ai-sdk-agent
npx skills add <fresh-tokenized-url> --skill plan-ai-sdk-agent

Restart the AI coding tool after installation or update so it reloads skill metadata.

Delivery and access

  1. The browser requests /api/skill-token/<skill-name>.
  2. The API authenticates the user, resolves their effective individual or team plan, and checks the skill catalog policy.
  3. The API signs a short-lived SKILL token bound to the catalog name.
  4. The Skills CLI discovers the token-bound manifest at /skill/<token>/.well-known/agent-skills/index.json and fetches only its allowlisted runtime files.
  5. /skill/<token> remains the direct packaged .skill ZIP response for compatible clients and artifact verification.

Every tokenized discovery, file, and artifact response verifies the service and skill binding, resolves only catalog/source paths, and uses no-store and CORS headers.

Unknown skills, unauthenticated requests, insufficient plans, invalid or expired tokens, cross-skill mismatches, and missing artifacts return distinct status/error codes.

Troubleshooting

  • 401 authentication required: sign in and generate the command again.
  • 403 plan upgrade required: confirm the skill's entitlement and your effective individual or team plan.
  • 401 invalid or expired token: return to the protected page for a fresh command.
  • 404 artifact missing: the catalog entry exists, but the release artifact has not been packaged yet.
  • Skill not visible after install: run npx skills list, confirm the selected target, then restart the coding tool.

Maintainers build the catalog artifacts with:

pnpm --filter=v4 skills:build

The compatibility aliases skill:package and skill:build remain available while callers migrate to the plural catalog commands.