integration-tests

Use this skill when writing or running integration tests. Provides approved model names and integration test guidelines.

📖 中文导读:Use this skill when writing or running integration tests. Provides approved model names and integration test guidelines. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: integration-tests description: Use this skill when writing or running integration tests. Provides approved model names and integration test guidelines.

Integration Test Guidelines

Guidelines for writing and running integration tests that make real API calls.

Approved Models

Use these models for integration tests:

Provider Model Name API Key Env Var
Anthropic claude-haiku-4-5-20251001 ANTHROPIC_API_KEY
OpenAI gpt-5-mini OPENAI_API_KEY
Google gemini-3-flash GOOGLE_API_KEY

Why These Models?

  • Fast: Optimized for low latency
  • Cost-effective: Cheapest tier for each provider
  • Capable: Still highly capable for test scenarios

Writing Integration Tests

Example Vibe Code

// Anthropic
model anthropic = { name: "claude-haiku-4-5-20251001", apiKey: env("ANTHROPIC_API_KEY") }

// OpenAI
model openai = { name: "gpt-5-mini", apiKey: env("OPENAI_API_KEY") }

// Google
model google = { name: "gemini-3-flash", apiKey: env("GOOGLE_API_KEY") }

Test File Location

Integration tests live in: tests/integration/

Running Integration Tests

# Run all integration tests (costs money, ~40s)
bun run test:integration

# Run a single integration test
bun test tests/integration/specific-test.test.ts

Important Notes

  1. Do NOT run full integration suite routinely - it costs money
  2. Use unit tests first - bun run test is fast and free
  3. Run targeted integration tests when verifying specific provider behavior
  4. Update model names when providers release new versions