Phaseo

Use Phaseo when you need one API for multiple AI providers, stable model discovery, routing controls, pricing visibility, async jobs, or agent-ready gateway workflows.

Operate and troubleshoot Phaseo through the official `phaseo` CLI. Use when installing or updating the CLI, authenticating with browser or device OAuth, managing API keys/workspaces/presets/guardrails, inspecting credits and analytics, investigating gateway requests by request ID, or automating Phaseo control-plane work with structured JSON output.

End-to-end migration guide for moving an existing OpenRouter integration to Phaseo Gateway. Use when repositories contain openrouter.ai endpoints, sk-or-v1 keys, OPENROUTER_API_KEY env vars, provider-prefixed model IDs, or OpenRouter-specific headers and the user wants a full migration with implementation, validation, and safe rollout.

Build agentic applications with the TypeScript Agent SDK (`@phaseo/agent-sdk`) on top of Phaseo Gateway. Use when repositories need local tool loops, resumable runs from app-owned state, or a gateway-backed agent client through `@phaseo/sdk`.

Build Phaseo async video, batch, and webhook integrations correctly. Use when repositories need long-running job creation, polling, websocket lifecycle helpers, standardized webhook payload handling, or operational recovery for async media and batch workflows.

Write and maintain Phaseo changelog pages in the required house style. Use when updating `apps/docs/v1/changelog.mdx`, `product-changelog.mdx`, `sdk-changelog.mdx`, or `data-changelog.mdx`, especially when entries need to be rebuilt from merged pull requests, release metadata, and model-release records.

Implement and migrate AI integrations to Phaseo Gateway via OpenAI-compatible REST, the official TypeScript SDK (@phaseo/sdk), Python SDK (phaseo), and Vercel AI SDK provider (@phaseo/ai-sdk-provider). Use when wiring new API calls, replacing OpenAI/Anthropic/OpenRouter/Vercel Gateway base URLs, adding app attribution headers, selecting model IDs, or troubleshooting auth/routing/response-shape issues.

Configure and debug Phaseo guardrails for API keys. Use when a repository or rollout needs workspace guardrails, model/provider restrictions, budget limits, prompt-injection handling, sensitive-info detection, preview testing, or verification through activity/log views.

Rewrite Phaseo documentation in a product-facing voice. Use when docs read like internal engineering notes, architecture commentary, or implementation diagnostics instead of helping customers get a result quickly.

Write Phaseo release spotlight posts and monthly shipping recaps from merged pull requests, changelog entries, and release metadata. Use when drafting or rewriting announcement posts such as "What we shipped", "release spotlight", or monthly recap content that needs stronger structure, clearer themes, concise product-facing language, and model-release call-to-actions.

Configure and debug Phaseo response healing for structured JSON workflows. Use when a repository needs preset or workspace plugin defaults, request-level plugin overrides, malformed JSON recovery, or log-based verification of healing behavior.

Roll out and debug Phaseo presets, routing policy, and response caching. Use when repositories need preset-driven request defaults, stable cache behavior, provider narrowing, or request-log investigation for routing outcomes and cache misses.

Implement Phaseo integrations with the official Python SDK (`phaseo`). Use when repositories already depend on `phaseo`, need a new client setup, Responses API calls, async video jobs, preset usage, or request logging patterns for the Python SDK surface.

Implement Phaseo integrations with the official TypeScript and JavaScript SDK (`@phaseo/sdk`). Use when repositories already depend on `@phaseo/sdk`, need a new client setup, Responses API calls, async video jobs, preset usage, or request logging patterns for the SDK surface.

Configure and debug Phaseo web search and grounding workflows. Use when a repository needs `gateway:web_search`, `gateway:web_fetch`, native provider web search, citation verification, or request-log debugging for search-heavy flows.

Next.js 16 Cache Components - PPR, use cache directive, cacheLife, cacheTag, updateTag

When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," or "SEO health check." For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema-markup.

Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).