Agent Skills: Tooltest fix loop

Use when running tooltest to validate MCP servers, interpret failures, and iterate fixes in this repo.

UncategorizedID: lambdamechanic/tooltest/tooltest-fix-loop

Skill Files

Browse the full folder contents for tooltest-fix-loop.

Download Skill

Loading file tree…

skills/tooltest-fix-loop/SKILL.md

Skill Metadata

Name
tooltest-fix-loop
Description
Use when running tooltest to validate MCP servers, interpret failures, and iterate fixes in this repo.

Tooltest fix loop

Run tooltest and iterate

  • Identify how to start the repo’s MCP server (stdio or streamable HTTP).
  • Run tooltest against it:
    • tooltest stdio --command "<server start command>"
    • tooltest http --url "<server mcp url>"
  • Read the failure report, trace the failing tool call or protocol step, and fix the smallest viable patch.
  • Re-run tooltest until it exits 0; keep tool names and schemas stable unless a spec violation requires change.

Triage guidance

  • Treat failures as either protocol handling, tool schema validation, or runtime behavior; fix in that order.
  • Prefer backward-compatible fixes; add a regression test when a failure is deterministic or easy to reproduce.
  • When the failure is intermittent, keep the smallest reproduction from the report and turn it into a test.

Reporting

  • Summarize the changes and why they address the specific tooltest failures.
  • Include the final passing tooltest output snippet.