How does the skill detect a script failure?

It scans the conversation history for executions of the '.plan/execute-script.py' pattern that returned a non-zero exit code.

What categories of root causes does it identify?

It identifies missing script instructions, incorrect parameters, LLM-invented scripts, missing APIs, script bugs, and invalid notations.

Can it automatically apply fixes to my code?

Yes, it proposes specific modifications to your components and provides an interactive prompt to apply those fixes using Claude's editing tools.

Does this work with any Claude Code project?

It is specifically optimized for projects using the Plan Marshall orchestration layer and its standardized script execution pattern.

Script Failure Analyzer

Name: Script Failure Analyzer
Author: cuioss

bycuioss

•

開発者ツール

Diagnoses script execution errors by tracing failures back to their source components and providing automated fix proposals.

The Script Failure Analyzer is a specialized diagnostic tool for the Plan Marshall orchestration layer that automates the debugging process within Claude Code. It identifies non-zero exit codes in script executions, traces the failure back to the specific command, agent, or skill that triggered it, and analyzes the instruction path to determine the root cause. Whether a failure stems from a missing script instruction, incorrect parameters, or an LLM-hallucinated command, this skill generates actionable remediation steps and integrates with a lessons-learned system to prevent future regressions.

主な機能

01Automated script failure detection and chat history analysis

02Root cause categorization including missing APIs and parameter errors

031 GitHub stars

04Interactive fix application for orchestration components

05Integration with Plan Marshall lessons-learned for long-term reliability

06Origin tracing for commands, agents, and active skills

ユースケース

01Standardizing error handling and instruction accuracy across custom plugins

02Debugging complex agentic workflows where a script fails unexpectedly

03Identifying and correcting instances where the LLM invents non-existent script calls

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cuioss/plan-marshall tools-analyze-script-failures

For use in Claude.ai and ChatGPT

Download Skill