Why should I clone conversations before debugging?

Cloning preserves the original bug evidence and allows for multiple reproduction attempts and A/B testing without modifying the source data.

How do conversation dumps help with prompt optimization?

They export the full message history to JSON or HTML, allowing you to use tools like jq to analyze the prompt structure and iterate on improvements.

What is the benefit of the -p flag in this skill?

The -p flag allows you to test specific tasks and functionality non-interactively, making it faster to verify changes and automate tests.

Should I use release builds for debugging?

No, the skill recommends standard debug builds as they are faster to compile and provide necessary symbols for troubleshooting.

Can I use this skill for any CLI tool?

While the workflow principles are universal, the specific commands and patterns are optimized for the Forge CLI application.

CLI Debug & Testing Workflow

Name: CLI Debug & Testing Workflow
Author: Activer007

byActiver007

0•

Security & Testing

Simplifies the debugging and extension of CLI applications through systematic build, test, and conversation cloning workflows.

The debug-cli skill provides a comprehensive framework for troubleshooting and enhancing command-line interfaces, specifically optimized for the code-forge application. It establishes a rigorous methodology for reproducing bugs safely by cloning conversations, verifying command documentation with automated help checks, and using non-interactive prompt testing. By integrating conversation dumping in both JSON and HTML formats, developers can perform deep-dive analyses into prompt structures and application behavior, ensuring that CLI modifications are stable and well-documented before deployment.

Key Features

01Non-destructive bug reproduction via conversation cloning

02Standardized debug build and documentation verification procedures

03Prompt optimization workflows using jq and conversation exports

040 GitHub stars

05Non-interactive testing patterns using the -p flag

06Automated conversation dumping to JSON and HTML for deep analysis

Use Cases

01Analyzing and optimizing AI-driven prompt structures in terminal applications

02Verifying new CLI features and command-line options without interactive overhead

03Fixing argument parsing bugs or command crashes in CLI tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills debug-cli

For use in Claude.ai and ChatGPT

Download Skill