foundry-test

Guide debugging of failing tests through a five-phase investigation workflow across pytest, Go test, and jest suites.

4|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundry-test
Source: https://github.com/foundry-works/claude-foundry/tree/main/skills/foundry-test
Command: npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-test

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a repeatable five-phase investigation workflow to guide debugging of failing tests, enabling faster root-cause analysis and consistent outcomes across languages.

Core Features & Use Cases

  • Five-phase workflow: Run tests, categorize failures, form hypotheses, gather context, and verify fixes with optional AI consultation.
  • Language-agnostic: Applicable to Python (pytest), Go, and JavaScript (jest) test suites with clear decision rules and context capture.
  • Documentation-guided debugging: Leverages built-in failure categories and investigation references to accelerate diagnosis and learning.
  • Quick Start-ready prompts: Ready-made prompts and templates for AI-assisted debugging and knowledge reuse.

Quick Start

Run a failing test in your language of choice (pytest, go test, or npm test) and follow Phase 2–5 steps to isolate and fix the issue.

Frequently Asked Questions about foundry-test

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to debug failing pytest tests systematically?

Debugging failing pytest tests systematically requires a five-phase investigation workflow that categorizes failures, forms hypotheses, and gathers context for AI-assisted root-cause analysis. This structured process ensures consistent outcomes and reliable fixes.

How do I investigate failing jest test suites using AI?

Investigate failing jest test suites using AI by running the failing tests, categorizing the failures, and feeding the captured context into ready-made AI prompts. This structured workflow guides hypothesis formation and verifies fixes through clear decision rules.

Can I use this structured debugging workflow for Go test failures?

Yes, you can use this structured debugging workflow for Go test failures. The language-agnostic workflow applies to Go test suites alongside Python and JavaScript, providing clear decision rules and context capture for AI-assisted analysis and reliable fixes.

How do you categorize test failures before forming a debugging hypothesis?

You categorize test failures by running the test suite and identifying the failure types using built-in investigation references during Phase 2. This failure categorization accelerates diagnosis and guides the subsequent hypothesis formation and context gathering phases.

Does structured test debugging work without external dependencies?

Yes, structured test debugging works without external dependencies. The workflow operates independently using built-in failure categories and investigation references to guide diagnosis, leveraging ready-made prompts for optional AI consultation and knowledge reuse.