fix-build
Diagnose and fix broken builds or failing tests with coordinated retries. Use when a build/test is broken, pre-commit hooks fail, or agents should coordinate a fix.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Fix Build
Purpose: coordinate a single fixer when builds/tests fail, run targeted diagnostics, apply minimal fixes, and re-verify.
Trigger
Use this skill when:
- pre-commit hooks fail (lint/typecheck/test)
- tests fail in CI or locally
- multiple agents might attempt the same fix
Flow
- Inspect the failure output and identify the first actionable root cause.
- Check build coordination state via SQLite (build_state).
- If this agent is the fixer, apply the smallest viable fix.
- Re-run the failing checks and report results.
- Mark build state as fixed on success.
Coordination
- If build_state indicates another fixer is active, wait before retrying.
- Avoid duplicate fix attempts; respect the fixer lock.
- If lock is stale, claim and proceed.
Reporting
Always report:
- failing command(s) and error snippet
- files changed and rationale
- verification commands and outcomes
- if coordination required waiting or lock cleanup
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-27
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!