build-error-resolver

A specialist workflow for diagnosing build, TypeScript, lint, and test failures. TypeScript checks code for type mistakes, while lint and tests catch style and behavior problems.

In plain words
What is it for?
Use it when delegated CI failures or surfaced errors need root-cause analysis across tools such as tsc, ESLint, Vitest, Webpack, or Vite.
Why use it?
It keeps large error logs and cross-file investigations focused instead of mixing them into broader project planning.

Cursor rule

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/ulises-jeremias/agent-toolkit/build-error-resolver
Clone the repo
git clone --depth 1 https://github.com/ulises-jeremias/agent-toolkit
Per session 1,104 This file is loaded in full into every session.
When invoked 1,104 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01104 $0.01104
Opus 5 $0.00552 $0.00552
Sonnet 5 $0.00221 $0.00221
Haiku 4.5 $0.00110 $0.00110

Measured 3d ago against content hash cc207e96c924, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

build-error-resolver scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/agent-toolkit-agents/rules/build-error-resolver.mdc · 78 lines

How it starts

The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.


name: build-error-resolver description: Build and TypeScript error resolution specialist — large diagnostic context, root-cause triage across tsc/lint/webpack/vite. Use when platform-engineer delegates CI failure logs or fix requires full error/stack analysis; opt-in via holistic caller — not a daily entry point. tools: Read, Grep, Glob, Bash kind: specialist

You are build-error-resolver at agent-toolkit — the opt-in build/type/lint diagnostic specialist.

Agent vs skill rule — why agent (cite clause)

  • Large diagnostic context + separate context: Build failures carry full compiler logs, stacks, and cross-file type graphs that exceed holistic platform-engineer's orchestration scope (CI lifecycle/forge worktrees). Isolated context keeps noisy logs from flooding the platform plan. Decision: KEEP AS SPECIALIST.

When to use vs holistic

  • Use this specialist when platform-engineer delegates forge/gh-fix-ci log triage or implementer surfaces tsc/eslint/vitest root-cause failures. Chain: Assistant → Platform Engineer → Build Error Resolver (docs/AGENT_TAXONOMY.md §5 #11).
  • Use platform-engineer directly for trivial log → minimal patch, branch/PR scaffolding, or when failure is pre-diagnosed.

Caller / skills / handoff

  • Caller (holistic owner): platform-engineer (canonical) via forge/gh-fix-ci + tooling/cli-for-agents; qa-engineer/implementer may delegate secondarily. See capabilities/skills/registry.yaml specialist_agents: [build-error-resolver].
  • Skills used: forge/gh-fix-ci (GH Actions diagnosis), tooling/cli-for-agents (CLI ergonomics), quality/megalinter-check via qa-engineer when lint-gated.
  • Expected handoff: Returns root-cause analysis + minimal fix + verification command to platform-engineer/implementer; they apply and qa-engineer re-verifies gates.

You are a build error resolution specialist at agent-toolkit. Fix compilation errors efficiently by targeting root causes, not symptoms.

Read the full file on GitHub · 78 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 78 lines · 1,104 tokens per session scan A cc207e96c924

Subscribe to this mod's changes

build-error-resolver is a cursor rule published in the GitHub repository ulises-jeremias/agent-toolkit (16 stars, last pushed 4d ago), licensed MIT. It adds 1,104 tokens to every session, about $0.0055 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other cursor rules, from other repositories

test-case-to-katalon-studio

Convert Katalon True Platform/TestOps manual test cases into Katalon Studio automation inside a local Studio Test Project checkout. Use when you need to author or extend a .tc test case file and its paired Groovy script under Scripts/, keep test case variable GUIDs consistent with the .ts test suite bindings that read…

katalon-labs/true-skills · 195 tokens

solana-transaction-safety

Safe Solana transaction submission patterns using Helius Sender.

helius-labs/core-ai · 390 tokens

execute-test

Execute Katalon True Platform/TestOps tests when the input is an existing test case, manual test case list, test suite, suite collection, execution request, or "run with AI" instruction. Use when you need to create a manual test run, start Run with AI, poll AI session results, schedule automated suites, read…

katalon-labs/true-skills · 136 tokens

test-maintenance

Maintain and evolve a Katalon True Platform/TestOps regression suite as the application changes. Use when you need to detect which tests broke or became flaky from stability and result history, diagnose whether a case needs repair vs regeneration, repair test assets (update, move, reorganize cases), refresh coverage…

katalon-labs/true-skills · 131 tokens

session-preflight

Require a visible session preflight before side-effecting agent work.

caioribeiroclw-pixel/pluribus · 184 tokens

git

Cursor rule "git" from duongductrong/cursor-kit, covering git conventions, commit messages, types, subject rules and examples.

duongductrong/cursor-kit · 285 tokens