llm-friendly-cli-messages

Standardize CLI output and error handling for LLM error recovery.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/PicoMLX/SwiftGog --skill llm-friendly-cli-messages
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: llm-friendly-cli-messages
Source: https://github.com/PicoMLX/SwiftGog/tree/main/.agents/skills/llm-friendly-cli-messages
Command: npx skills add https://github.com/PicoMLX/SwiftGog --skill llm-friendly-cli-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the issue of opaque, dead-end error messages in command-line tools that prevent LLMs from self-correcting during automated tasks.

Core Features & Use Cases

  • Actionable Error Design: Provides a framework for transforming raw API errors into clear, fixable instructions for AI agents.
  • Standardized Exit Codes: Defines a stable exit code schema to help agents distinguish between usage errors, policy refusals, and authentication failures.
  • Use Case: When building a custom CLI tool, use these principles to ensure that when an API call fails due to a missing permission, the tool tells the LLM exactly which scope to request rather than simply returning a generic error.

Quick Start

Apply the llm-friendly-cli-messages guidelines to your current command-line tool project to improve agentic error recovery.

Frequently Asked Questions about llm-friendly-cli-messages

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

FAQPage Schema
How do I design CLI error messages for LLM automated error recovery?

To design CLI error messages for LLM automated error recovery, you should transform raw API errors into clear, actionable instructions and apply deterministic exit code mapping so agents can distinguish between usage errors and authentication failures.

What are the best practices for structured logging in agentic workflows?

Best practices for structured logging in agentic workflows involve adhering to standardized schemas that provide deterministic exit codes and actionable feedback, ensuring autonomous LLMs can self-correct during automated command-line tasks.

How does deterministic exit code mapping work for CLI tools?

Deterministic exit code mapping for CLI tools works by defining a stable schema that allows AI agents to reliably distinguish between usage errors, policy refusals, and authentication failures during automated execution.

Why do LLM agents fail to self-correct when using command-line tools?

LLM agents fail to self-correct when using command-line tools because of opaque, dead-end error messages that lack actionable context, preventing the agent from understanding exactly which permission scope or parameter to fix.

Can I use actionable error messaging principles for API wrappers?

Yes, you can apply actionable error messaging principles to API wrappers to ensure that when API calls fail, the wrapper outputs structured logs and clear instructions detailing exactly which scope to request for autonomous recovery.

When do I need to standardize command-line interface output for automation scripts?

You need to standardize command-line interface output for automation scripts when building agent-driven workflows, ensuring your tools provide structured logging and actionable error messaging to prevent dead-end failures.