creating-debug-tests-and-iterating

Create external-interface scripts to reproduce bugs via CLI, API, and GUI flows.

149|10|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/tilework-tech/nori-profiles --skill creating-debug-tests-and-iterating
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-debug-tests-and-iterating
Source: https://github.com/tilework-tech/nori-profiles/tree/main/src/cli/features/claude-code/profiles/config/_mixins/_swe/skills/creating-debug-tests-and-iterating
Command: npx skills add https://github.com/tilework-tech/nori-profiles --skill creating-debug-tests-and-iterating

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reproduce and diagnose tricky bugs by running external, real-interface tests against the application. It guides you to log comprehensively, run the tests iteratively, and clean up after fixes, reducing guesswork and downtime.

Core Features & Use Cases

  • External Debugging: Create scripts that interact with the application's public interfaces (CLI, API) rather than internal components.
  • Iterative Fix Loop: Run tests, analyze logs, update the script, and repeat until the issue is resolved.
  • Reality-Driven Validation: Ensures bugs observed in production-like environments are reproducible and verifiable.

Quick Start

Create a script that calls the application from the outside (CLI or API), then run it, inspect logs, and incrementally adjust until the bug surfaces clearly and is fixed.

Frequently Asked Questions about creating-debug-tests-and-iterating

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

FAQPage Schema
How do I create a test script that reproduces a bug using external interfaces like CLI or API?

External debugging tests interact with your application's public interfaces rather than internal components. Create a script that calls your CLI or API endpoints, run it against the live application, inspect logs for the bug, then iteratively adjust the script until the issue surfaces and you can fix it.

What's the best way to debug issues that only appear under realistic production-like conditions?

Bugs in production environments often depend on real workflows, authentication, and data state. Build external-interface scripts that replicate those exact conditions—including API calls, CLI commands, and logging—then run them repeatedly while analyzing logs and refining your fix until tests pass consistently.

How do I set up logging and iteration to diagnose API or CLI bugs faster?

Enable comprehensive logging in your application, then create a test script that exercises the API or CLI flow where the bug occurs. Run the script, review logs for the failure point, update your script or fix the code, and repeat until the bug is resolved and your test passes reliably.

Can I automate bug reproduction for scenarios requiring authentication and multiple steps?

Yes. External debugging supports authenticated flows, multi-step interactions, and real-time logging. Build a script that handles login, performs the sequence of CLI or API calls that triggers the bug, then logs and reports results so you can iterate without manual testing.

Why should I use external tests instead of unit tests for production bugs?

External tests validate behavior through the same interfaces users encounter, catching bugs that only appear in realistic conditions—network latency, data state, authentication—rather than in isolated unit tests. This ensures fixes work in production environments.

How do I clean up after fixing a bug discovered through external testing?

After your external test script passes and the bug is fixed, verify all tests pass end-to-end, remove any temporary test data or logging added during debugging, and keep the test script as a regression guard for future iterations.