| name | devcheck |
| description | Lint, format, typecheck, and verify the project is clean. Use after making changes, before committing, or when the user asks to verify quality.
|
| metadata | {"author":"cyanheads","version":"1.3","audience":"external","type":"workflow"} |
What It Runs
bun run devcheck runs a broader check suite than just lint + types. By default it includes local hygiene checks, MCP definition linting, Biome, TypeScript, and slow dependency/security checks unless --fast is passed. Tests are opt-in via --test.
| Check | Tool | Notes |
|---|
| TODOs / FIXMEs | git grep | Fails on tracked TODO/FIXME markers outside excluded files |
| Tracked secrets | git ls-files | Flags tracked .env, keys, credentials, and similar sensitive files |
| MCP definitions | bun run scripts/lint-mcp.ts | Validates tool/resource/prompt definitions against framework rules |
| Biome | biome check | Unified lint + format — read-only by default |
| TypeScript | tsc --noEmit | Full project type check |
| Unused dependencies | depcheck | Runs by default; network-free but slower on large repos |
| Security audit | bun audit | Runs by default unless --fast or --no-audit |
| Outdated dependencies | bun outdated | Runs by default unless --fast or --no-deps |
| Tests | vitest run | Off by default; enable with bun run devcheck --test |
To auto-fix lint/format issues, run bun run format.
Steps
- Run
bun run devcheck
- Read the failing checks in the summary and per-check output
- Fix the reported issues
- Re-run
bun run devcheck until clean
- If the change touches runtime behavior, also run
bun run devcheck --test or bun run test
- Do not consider this skill complete until the required commands exit successfully with no errors
Common Issues
| Check | Error Type | Typical Fix |
|---|
| TODOs / FIXMEs | Tracked work markers | Resolve or remove the marker before committing |
| Tracked secrets | Sensitive files in git | Add to .gitignore and remove from the index |
| MCP definitions | Definition lint errors | Fix schema/name/annotation issues reported by lint-mcp |
| Biome | Lint/format errors | Run bun run format to auto-fix, or address the flagged rule manually |
| TypeScript | Type errors | Fix type mismatches, missing properties, incorrect generics |
| Security audit | Vulnerabilities in direct deps | Update or replace the affected dependency |
| Outdated deps | Stale package versions | Run bun update or allowlist intentionally pinned packages |
Checklist
