Menu
Build, typecheck, and test the agentick monorepo. Use when asked to verify changes, run checks, or ensure nothing is broken.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create a new agentick tool using createTool. Use when asked to add a tool, create a tool, or implement tool functionality.
Add a new package to the agentick monorepo. Use when creating a new @agentick/* package.
Create a new agentick lifecycle hook or custom hook. Use when asked to add a hook, create reactive behavior, or implement lifecycle logic.
Test an agentick agent with mock model responses. Use when asked to write tests, test an agent, or verify agent behavior.
Create a new model adapter for agentick. Use when asked to add support for a new model provider (Anthropic, Mistral, Cohere, etc).
Create a new agentick JSX component. Use when asked to add a component, create a UI primitive, or build a reusable agent building block.
| name | build-and-check |
| description | Build, typecheck, and test the agentick monorepo. Use when asked to verify changes, run checks, or ensure nothing is broken. |
After making changes, run the appropriate checks:
# Typecheck everything (fast, catches most issues)
pnpm typecheck
# Typecheck a specific package
pnpm --filter @agentick/core typecheck
pnpm --filter @agentick/kernel typecheck
# Run all tests
pnpm test
# Run tests for a specific package
pnpm --filter @agentick/core test
pnpm --filter @agentick/gateway test
# Run a single test file
pnpm vitest run packages/core/src/hooks/__tests__/knob.spec.ts
# Full build (slower, for publishing verification)
pnpm build
| Change | Command |
|---|---|
| Modified a type/interface | pnpm typecheck (ALL packages — structural typing) |
| Modified a single package | pnpm --filter @agentick/PACKAGE typecheck && pnpm --filter @agentick/PACKAGE test |
| Modified kernel or shared | pnpm typecheck && pnpm test (foundation packages affect everything) |
| Added a new export | pnpm typecheck |
| Before committing | pnpm typecheck && pnpm test |
| Before publishing | pnpm build && pnpm typecheck && pnpm test |
When modifying a TypeScript interface, always run full pnpm typecheck — not just the package you edited. Structural typing means anonymous object literals in other packages may implement your interface without explicitly referencing it.
Grep for the property name across all .ts files, not just the interface name:
# If you renamed or deleted a property called "eventBuffer":
grep -r "eventBuffer" packages/ --include="*.ts"
pnpm install fails with CodeArtifact error: Your ~/.npmrc may have a stale registry. Workaround:
NPM_CONFIG_REGISTRY=https://registry.npmjs.org pnpm install
Type error in a package you didn't touch: Likely a structural typing issue. Check if your interface change affects object literals elsewhere.
Test timeout: Default vitest timeout is 5s. For async agent tests, ensure cleanup() is called in afterEach.