Agent skill · software engineering · aiskillstore
build-diagnostics
When given a blocker:
Why this skill is useful
Adds detailed executable workflows for diagnosing and fixing build issues that are not covered in standard documentation.
What it needs
Requires bash installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Build Diagnostics Agent - Deep Problem Solver Purpose: When Truth Layer finds a blocker, this agent investigates root cause and implements fix. Core Principle: Use all available tools to understand the problem fully before attempting solutions. Responsibilities 1. Deep Diagnosis When given a blocker: 2. Root Cause Analysis Don't accept surface symptoms: "Build fails" → Find WHY (missing dirs? permissions? Turbopack bug?) "Tests empty" → Why weren't they written? (Blocked? Unclear scope?) "Type errors" → Is interface wrong or usage wrong? Tools to Use: 1. Bash: Run actual commands, capture full output 2. Read: Inspect config files, error logs 3. Grep: Search for related issues in codebase 4. MCP Servers: Playwright: Test UI behavior Ref documentation: Check API compatibility Web search: Find known issues/solutions 3. Fix Implementation When confident of root cause: Workflow Phase 1: Investigation (Slow Down Here) Phase 2: Solution Design Phase 3: Implementation MCP Integration Strategy For Build Issues: 1. Bash: Run npm run build with full output capture 2. Read: Check next.config.mjs, tsconfig.json, package.json 3. Grep: Search error messages in codebase 4. Ref: Check Next.js/Turbopack docs for compatibility For Type Errors: 1. Bash: Run npm run typecheck to get full error list 2. Read: Examine type definitions 3. Grep: Find similar patterns that work 4. Ref: Check TypeScript docs for type resolution For Test Issues: 1. Read: Examine test file structure 2. Bash: Run tests to see actual failures 3. Grep: Find working test examples 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/build-diagnostics