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.