cli2skill
Mechanically generates an Agent Skill markdown file from any CLI's --help output or an MCP server's tool list.
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 16, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Jul 18, 2026 · a07632a
Actually ran it against 3 real CLIs: clean on gh (reproduced the README's own example exactly, correct description + all 32 subcommands), correct subcommand list but a useless generic top-level description on pip, and a near-empty, unusable skill file for git -- despite the SKILL.md's own description promising 'any command-line tool's --help output.' Requires a separate `pip install cli2skill` beyond dropping the markdown file.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 6/10
- Docs & honesty 2/5
What cli2skill does
A Python CLI (pip install cli2skill) plus a thin SKILL.md wrapper that parses --help text (or handshakes with an MCP server) and emits a ready-to-drop SKILL.md, aimed at replacing persistent MCP-server processes with zero-overhead Bash-invoked skills. Triggers when a user wants to convert an MCP server to a CLI skill or generate a skill from a command-line tool's help output.
How to install cli2skill
git clone https://github.com/2233admin/cli2skill
mkdir -p ~/.claude/skills
cp -r cli2skill ~/.claude/skills/cli2skill
# then, to actually run the generator commands the SKILL.md documents:
pip install cli2skill
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger cli2skill
-
/cli2skillMechanically generates an Agent Skill markdown file from any CLI's --help output or an MCP server's tool list.
It also activates on plain-language prompts like these:
-
Turn the gh CLI's help output into a ready-to-use skill markdown file -
Generate a skill file from this MCP server's tool list instead -
Convert my custom CLI's --help text into an Agent Skill markdown file
Frequently asked questions
- Is the cli2skill skill free?
- Yes. The skill itself is free from 2233admin/cli2skill. SkillProof publishes the install command and an independent test verdict at no cost.
- Does cli2skill work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 16, 2026. Verdict: Works with setup. Actually ran it against 3 real CLIs: clean on gh (reproduced the README's own example exactly, correct description + all 32 subcommands), correct subcommand list but a useless generic top-level description on pip, and a near-empty, unusable skill file for git -- despite the SKILL.md's own description promising 'any command-line tool's --help output.' Requires a separate `pip install cli2skill` beyond dropping the markdown file.
- What is the cli2skill SkillProof Score?
- 7.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 6/10, docs & honesty 2/5.
- How do I install cli2skill?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use cli2skill with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.