2026 07 10

---
title: x0c/agent-friendly-cli-skill
category: daily-digests/2026-07-10
tech_stack:
- Markdown
- CLI Design
- JSON Contracts
- Agent Integration
- Verification Methodology
quality_score: 8
rag_relevance: 9
tags:
- CLI design
- AI agent compatibility
- non-interactive mode
- JSON contracts
- verification checklist
source: https://github.com/x0c/agent-friendly-cli-skill
discovered_at: '2026-07-10T06:15:15Z'
evaluated_by: mistral-small-latest
---

## Summary
A skill for designing, building, and reviewing command-line tools that AI agents can call reliably while remaining usable for humans. It provides a layered design standard (P0/P1/P2), real-world pitfalls, and an evidence-based acceptance checklist for CLI tools.

## Key Features
- Defines P0 hard requirements for agent-friendly CLIs (non-interactive mode, JSON envelopes, layered exit codes, dry-run, verification commands)
- Provides structured guidance for human-and-machine dual-audience compatibility
- Includes battle-tested pitfalls and their consequences with mitigation rules
- Offers an evidence-based acceptance checklist requiring real command outputs as proof
- Language-agnostic design standard that composes with language-specific CLI skills

## Why It Matters for RAG Builders
It standardizes the design and verification of CLIs for AI agents, ensuring reliability, low ambiguity, and reproducibility without sacrificing human usability.

## Tech Stack Deep Dive
### Markdown
Automated review identified **Markdown** as a key module contributing to infrastructure orchestration or cognitive reasoning boundaries in this project.

### CLI Design
Automated review identified **CLI Design** as a key module contributing to infrastructure orchestration or cognitive reasoning boundaries in this project.

### JSON Contracts
Automated review identified **JSON Contracts** as a key module contributing to infrastructure orchestration or cognitive reasoning boundaries in this project.

### Agent Integration
Automated review identified **Agent Integration** as a key module contributing to infrastructure orchestration or cognitive reasoning boundaries in this project.

### Verification Methodology
Automated review identified **Verification Methodology** as a key module contributing to infrastructure orchestration or cognitive reasoning boundaries in this project.



## Installation
```bash
# Install instruction (default)
pip install -r requirements.txt
```

## Related Vault Entries
<!-- Auto-populated by build-index.js based on tech_stack overlap -->