ReddRadar
Agent skill
running-scripts
How to run scripts in this pnpm + turbo monorepo. Covers turbo task filtering, caching, package-local scripts, and common pitfalls.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/productivity/running-scripts-jasonkuhrt-kitz
SKILL.md
Running Scripts
Key Principle
Always run from root directory unless you specifically need package-local behavior. Turbo handles dependencies automatically.
Common Commands
Building
# Build all packages (respects dependency order)
pnpm turbo build
# Build specific package
pnpm turbo build --filter=@kitz/core
# Build package and its dependencies
pnpm turbo build --filter=@kitz/assert...
# Force rebuild (bypass cache)
pnpm turbo build --filter=@kitz/core --force
Type Checking
# Type check all packages
pnpm turbo check:types
# Type check specific package
pnpm turbo check:types --filter=@kitz/assert
Linting
# Lint all packages
pnpm turbo check:lint
# Lint specific package
pnpm turbo check:lint --filter=@kitz/core
Package Validation
# Validate package.json exports (publint + attw)
pnpm turbo check:package
# Validate specific package
pnpm turbo check:package --filter=@kitz/core
Testing
# Run tests for specific file (use vitest directly)
pnpm vitest packages/core/src/arr/_.test.ts --run
# Run tests for a package directory
pnpm vitest packages/core/src/arr/ --run
# Run all tests via turbo
pnpm turbo test
# ALWAYS use --run to avoid watch mode
Formatting
# Format all files
pnpm format
# Check formatting
pnpm format:check
Development Mode
# Watch mode for a package (rebuilds on changes)
pnpm turbo dev --filter=@kitz/core
Release
# Publish packages with changesets
pnpm release
Turbo Cache
Turbo caches task outputs. If you change source files, it rebuilds. If nothing changed, it replays cached output.
Cache hit = "replaying logs" in output (task skipped)
To force fresh run:
pnpm turbo build --force
Or delete the build folder:
rm -rf packages/core/build && pnpm turbo build --filter=@kitz/core
Package-Local Scripts
Some packages have scripts in scripts/ directories that aren't npm scripts. Run with tsx:
# Assert package - regenerate builder code
tsx packages/assert/scripts/generate-builder.ts
Common Pitfalls
| Problem | Solution |
|---|---|
| Cache hit when you expected rebuild | Use --force or delete build/ folder |
| Tests stuck in watch mode | Always use --run flag with vitest |
| Build order wrong | Turbo handles this via dependsOn: ["^build"] |
Notes
- Task dependencies and caching are configured in
turbo.jsonat project root
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?