Agent skill

code-change-verification

Run the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents JS monorepo.

Stars 2,570
Forks 665

Install this agent skill to your Project

npx add-skill https://github.com/openai/openai-agents-js/tree/main/.agents/skills/code-change-verification

SKILL.md

Code Change Verification

Overview

Ensure work is only marked complete after installing dependencies, building, linting, type checking (including generated declarations), and tests pass. Use this skill when changes affect runtime code, tests, or build/test configuration.

Quick start

  1. Keep this skill at ./.agents/skills/code-change-verification so it loads automatically for the repository.
  2. macOS/Linux: bash .agents/skills/code-change-verification/scripts/run.sh.
  3. Windows: powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1.
  4. If any command fails, fix the issue, rerun the script, and report the failing output.
  5. Confirm completion only when all commands succeed with no remaining issues.

Manual workflow

  • Run from the repository root in these phases: pnpm i, pnpm build, then pnpm -r build-check, pnpm -r -F "@openai/*" dist:check, pnpm lint, and pnpm test.
  • The skill may execute the final validation phase in parallel, but every step above must still pass.
  • Do not skip steps; stop and fix issues immediately when any step fails.
  • Re-run the full stack after applying fixes so the commands execute with the same barriers and coverage.

Resources

scripts/run.sh

  • Executes the full verification sequence (including declaration checks) with fail-fast semantics.
  • Keeps pnpm i and pnpm build as barriers, then runs independent validation steps in parallel.
  • Prefer this entry point to ensure the commands always run from the repo root with the expected fail-fast behavior.

scripts/run.ps1

  • Windows-friendly wrapper that runs the same verification sequence with fail-fast semantics.
  • Use from PowerShell with execution policy bypass if required by your environment.

Expand your agent's capabilities with these related and highly-rated skills.

openai/openai-agents-js

openai-knowledge

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.

2,570 665
Explore
openai/openai-agents-js

final-release-review

Perform a release-readiness review by locating the previous release tag from remote tags and auditing the diff (e.g., v1.2.3...<commit>) for breaking changes, regressions, improvement opportunities, and risks before releasing openai-agents-js.

2,570 665
Explore
openai/openai-agents-js

examples-auto-run

Run examples:start-all in auto mode with parallel execution, per-script logs, and start/stop helpers.

2,570 665
Explore
openai/openai-agents-js

implementation-strategy

Decide how to implement runtime and API changes in openai-agents-js before editing code. Use when a task changes exported APIs, runtime behavior, schemas, tests, or docs and you need to choose the compatibility boundary, whether shims or migrations are warranted, and when unreleased interfaces can be rewritten directly.

2,570 665
Explore
openai/openai-agents-js

docs-sync

Analyze main branch implementation and configuration to find missing, incorrect, or outdated documentation in docs/. Use when asked to audit doc coverage, sync docs with code, or propose doc updates/structure changes. Only update English docs (docs/src/content/docs/**) and never touch translated docs under docs/src/content/docs/ja, ko, or zh. Provide a report and ask for approval before editing docs.

2,570 665
Explore
openai/openai-agents-js

pnpm-upgrade

Keep pnpm current: run pnpm self-update/corepack prepare, align packageManager in package.json, and bump pnpm/action-setup + pinned pnpm versions in .github/workflows to the latest release. Use this when refreshing the pnpm toolchain manually or in automation.

2,570 665
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results