Agent skill

task-debugger

Debug and fix Taskcluster task failures

View SKILL.md on GitHub Repository
Stars 2
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/ahal/dot-files/tree/main/llm/claude-skills/task-debugger

SKILL.md

Setup

Taskcluster CLI:

bash
taskcluster version  # check if installed
export TASKCLUSTER_ROOT_URL=https://firefox-ci-tc.services.mozilla.com

If not installed: https://github.com/taskcluster/taskcluster/releases/latest/

Commands:

  • taskcluster task log <task-id> - Get logs
  • taskcluster task def <task-id> - Get definition (optional)

Debug Process

  1. Extract task ID from message or URL
  2. Fetch logs: taskcluster task log <task-id>
  3. Analyze errors (tracebacks, test failures, build errors)
  4. If fix is obvious → apply it. Otherwise → reproduce locally:
    • Docker-worker tasks: taskgraph load-task --develop <task-id> (Firefox: ./mach taskgraph, others: check virtualenv or uv run taskgraph)
    • Flags: --interactive, --volume, --root, --image, --keep
    • Non-docker: extract command from task def and run locally
  5. For non-obvious issues: add debug statements → iterate → fix
  6. Verify fix using same reproduction method
  7. Clean up debug artifacts (don't re-verify after cleanup)
  8. Report: root cause, fix, verification, files changed

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results