api-pro_skill

Overview

This skill is an API integration specialist focused on secure, resilient, and edge-first integrations for 2026. It provides production-ready patterns for Auth.js v5, GPT-5/generative model orchestration, Stripe SDK v13+, and context packing for large codebases. The skill emphasizes low-latency Edge execution, autonomous agent workflows, and robust error handling.

How this skill works

The skill inspects authentication flows, environment variable conventions, and edge-compatible session handling (AUTH_ prefix). It reviews model orchestration patterns for GPT-5 and o3, including reasoning token management and long-running research loops. It validates Stripe interactions, applies resilience patterns (exponential backoff, circuit breakers, bulkheads), and recommends context-packing/indexing strategies for agent consumption.

When to use it

• Implementing Auth.js v5 for Edge-compatible authentication and stateless sessions
• Orchestrating multi-model agent workflows with GPT-5 and o3 for planning and research
• Integrating Stripe v13+ with auto-pagination and strict type-safe expansions
• Hardening API clients with timeouts, retries, circuit breakers, and rate-limit handling
• Preparing large monorepos for AI agents via context packing or CODEBASE_INDEX generation

Best practices

• Prefix all auth-related environment variables with AUTH_ to enable secure automatic discovery
• Use JWT/session strategy for stateless Edge sessions and avoid heavy DB adapters in middleware
• Validate all external responses with schema validators (zod) instead of using any
• Implement exponential backoff + circuit breaker to prevent retry cascades and fail fast
• Acknowledge webhooks immediately and queue heavy work; verify signatures with Web Crypto APIs

Example use cases

• Edge middleware using Auth.js v5 serving sub-100ms cold starts with cached JWTs
• Agent orchestrator planning with GPT-5 reasoning tokens and executing research via o3
• Cleanup job iterating Stripe subscriptions using native async auto-pagination
• Resilient API client that bulkheads billing and search clients to isolate failures
• Generating a CODEBASE_INDEX.json to quickly guide AI agents through a 100k+ line repo