"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
refactor: rename skill files to SKILL.md, drop software prefix from filename
yuhaof73833d15a45
diff --git a/README.md b/README.mdindex 4df34e014..9008f57d9 100644--- a/README.md+++ b/README.md@@ -368,6 +368,18 @@ All CLIs organized under cli_anything.* namespace β conflict-free, pip-install</tr></table>+### π€ SKILL.md Generation++Each generated CLI includes a `SKILL.md` file at `<software>/agent-harness/skills/SKILL.md` β a self-contained skill definition that enables AI agents to discover and use the CLI through Claude Code's skill system or other agent frameworks.++**What SKILL.md provides:**+- **YAML frontmatter** with name and description for agent skill discovery+- **Command groups** with all available subcommands documented+- **Usage examples** for common workflows+- **Agent-specific guidance** for JSON output, error handling, and programmatic use++SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_generator.py`, which extracts metadata directly from the CLI's Click decorators, setup.py, and README.+---## π¬ Demonstrations@@ -744,7 +756,7 @@ We welcome contributions! CLI-Anything is designed to be extensible:- [ ] Community-contributed CLI harnesses for internal/custom software- [ ] Integration with additional agent frameworks beyond Claude Code- [ ] Support packaging APIs for closed-source software and web services into CLIs-- [ ] Produce SKILL.md alongside the CLI for agent skill discovery and orchestration+- [x] Produce SKILL.md alongside the CLI for agent skill discovery and orchestration---diff --git a/anygen/agent-harness/skills/anygen_SKILL.md b/anygen/agent-harness/skills/SKILL.mdsimilarity index 100%rename from anygen/agent-harness/skills/anygen_SKILL.mdrename to anygen/agent-harness/skills/SKILL.mddiff --git a/audacity/agent-harness/skills/audacity_SKILL.md b/audacity/agent-harness/skills/SKILL.mdsimilarity index 100%rename from audacity/agent-harness/skills/audacity_SKILL.mdrename to audacity/agent-harness/skills/SKILL.mddiff --git a/blender/agent-harness/skills/blender_SKILL.md b/blender/agent-harness/skills/SKILL.mdsimilarity index 100%rename from blender/agent-harness/skills/blender_SKILL.mdrename to blender/agent-harness/skills/SKILL.mddiff --git a/cli-anything-plugin/HARNESS.md b/cli-anything-plugin/HARNESS.mdindex 9de518b81..158b5088c 100644--- a/cli-anything-plugin/HARNESS.md+++ b/cli-anything-plugin/HARNESS.md@@ -74,7 +74,7 @@ designed for humans, without needing a display or mouse.```pythonfrom cli_anything.<software>.utils.repl_skin import ReplSkin- skin = ReplSkin("<software>", version="1.0.0", skill_path="skills/<software>_SKILL.md")+ skin = ReplSkin("<software>", version="1.0.0", skill_path="skills/SKILL.md")skin.print_banner() # Branded startup box (includes skill path for agents)pt_session = skin.create_prompt_session() # prompt_toolkit with history + stylingline = skin.get_input(pt_session, project_name="my_project", modified=True)@@ -260,7 +260,7 @@ definition that can be loaded by Claude Code or other AI assistants.skill_path = generate_skill_file(harness_path="/path/to/agent-harness",- output_path="skills/<software>_SKILL.md"+ output_path="skills/SKILL.md")```@@ -282,14 +282,14 @@ By default, SKILL.md files are generated in the `skills/` directory:<software>/βββ agent-harness/βββ skills/- βββ <software>_SKILL.md+ βββ SKILL.md```**Manual Generation:**```bashcd cli-anything-plugin-python skill_generator.py /path/to/software/agent-harness -o skills/software_SKILL.md+python skill_generator.py /path/to/software/agent-harness -o skills/SKILL.md```**Integration with CLI Build:**@@ -316,8 +316,8 @@ documentation when using the CLI:# In the REPL initialization (e.g., shotcut_cli.py)from cli_anything.<software>.utils.repl_skin import ReplSkin-skin = ReplSkin("<software>", version="1.0.0", skill_path="skills/<software>_SKILL.md")-skin.print_banner() # Now displays: β Skill: skills/<software>_SKILL.md+skin = ReplSkin("<software>", version="1.0.0", skill_path="skills/SKILL.md")+skin.print_banner() # Now displays: β Skill: skills/SKILL.md```This enables agents to know exactly where to find the skill definition when theydiff --git a/cli-anything-plugin/README.md b/cli-anything-plugin/README.mdindex 1d19351fc..233c8c73b 100644--- a/cli-anything-plugin/README.md+++ b/cli-anything-plugin/README.md@@ -216,7 +216,7 @@ Generate AI-discoverable skill definition:- Extract CLI metadata using `skill_generator.py`- Generate SKILL.md with YAML frontmatter (name, description)- Include command groups, examples, and agent-specific guidance-- Output to `skills/<software>_SKILL.md`+- Output to `skills/SKILL.md`**Output:** SKILL.md file for AI agent discovery@@ -239,7 +239,7 @@ Package and install:βββ <SOFTWARE>.md # Software-specific SOPβββ setup.py # PyPI config (find_namespace_packages)βββ skills/ # Generated skill definitions- β βββ <software>_SKILL.md # AI-discoverable skill file+ β βββ SKILL.md # AI-discoverable skill fileβββ cli_anything/ # Namespace package (NO __init__.py)βββ <software>/ # Sub-package (HAS __init__.py)βββ README.md # Installation and usagediff --git a/cli-anything-plugin/commands/cli-anything.md b/cli-anything-plugin/commands/cli-anything.mdindex d907bd54a..a0772d12c 100644--- a/cli-anything-plugin/commands/cli-anything.md+++ b/cli-anything-plugin/commands/cli-anything.md@@ -73,7 +73,7 @@ This command implements the complete cli-anything methodology to build a product- Extracts CLI metadata using `skill_generator.py`- Generates SKILL.md with YAML frontmatter and Markdown body- Includes command groups, examples, and agent-specific guidance-- Outputs to `skills/<software>_SKILL.md` by default+- Outputs to `skills/SKILL.md` by default- Makes the CLI discoverable and usable by AI agents### Phase 7: PyPI Publishing and Installationdiff --git a/cli-anything-plugin/repl_skin.py b/cli-anything-plugin/repl_skin.pyindex c279b581d..7a245e9f5 100644--- a/cli-anything-plugin/repl_skin.py+++ b/cli-anything-plugin/repl_skin.py@@ -6,7 +6,7 @@ Copy this file into your CLI package at:Usage:from cli_anything.<software>.utils.repl_skin import ReplSkin- skin = ReplSkin("shotcut", version="1.0.0", skill_path="skills/shotcut_SKILL.md")+ skin = ReplSkin("shotcut", version="1.0.0", skill_path="skills/SKILL.md")skin.print_banner()prompt_text = skin.prompt(project_name="my_video.mlt", modified=True)skin.success("Project saved")diff --git a/cli-anything-plugin/skill_generator.py b/cli-anything-plugin/skill_generator.pyindex 115da5027..a15705578 100644--- a/cli-anything-plugin/skill_generator.py+++ b/cli-anything-plugin/skill_generator.py@@ -481,7 +481,7 @@ def generate_skill_file(harness_path: str, output_path: Optional[str] = None,if output_path is None:# Default to skills/ directory under harness_pathharness_path_obj = Path(harness_path)- output_path = harness_path_obj / "skills" / f"{metadata.software_name}_SKILL.md"+ output_path = harness_path_obj / "skills" / "SKILL.md"else:output_path = Path(output_path)@@ -507,7 +507,7 @@ if __name__ == "__main__":)parser.add_argument("-o", "--output",- help="Output path for SKILL.md (default: skills/<software>_SKILL.md)",+ help="Output path for SKILL.md (default: skills/SKILL.md)",default=None)parser.add_argument(diff --git a/drawio/agent-harness/skills/drawio_SKILL.md b/drawio/agent-harness/skills/SKILL.mdsimilarity index 100%rename from drawio/agent-harness/skills/drawio_SKILL.mdrename to drawio/agent-harness/skills/SKILL.mddiff --git a/gimp/agent-harness/skills/gimp_SKILL.md b/gimp/agent-harness/skills/SKILL.mdsimilarity index 100%rename from gimp/agent-harness/skills/gimp_SKILL.mdrename to gimp/agent-harness/skills/SKILL.mddiff --git a/inkscape/agent-harness/skills/inkscape_SKILL.md b/inkscape/agent-harness/skills/SKILL.mdsimilarity index 100%rename from inkscape/agent-harness/skills/inkscape_SKILL.mdrename to inkscape/agent-harness/skills/SKILL.mddiff --git a/kdenlive/agent-harness/skills/kdenlive_SKILL.md b/kdenlive/agent-harness/skills/SKILL.mdsimilarity index 100%rename from kdenlive/agent-harness/skills/kdenlive_SKILL.mdrename to kdenlive/agent-harness/skills/SKILL.mddiff --git a/libreoffice/agent-harness/skills/libreoffice_SKILL.md b/libreoffice/agent-harness/skills/SKILL.mdsimilarity index 100%rename from libreoffice/agent-harness/skills/libreoffice_SKILL.mdrename to libreoffice/agent-harness/skills/SKILL.mddiff --git a/obs-studio/agent-harness/skills/obs_studio_SKILL.md b/obs-studio/agent-harness/skills/SKILL.mdsimilarity index 100%rename from obs-studio/agent-harness/skills/obs_studio_SKILL.mdrename to obs-studio/agent-harness/skills/SKILL.mddiff --git a/shotcut/agent-harness/skills/shotcut_SKILL.md b/shotcut/agent-harness/skills/SKILL.mdsimilarity index 100%rename from shotcut/agent-harness/skills/shotcut_SKILL.mdrename to shotcut/agent-harness/skills/SKILL.mddiff --git a/zoom/agent-harness/skills/zoom_SKILL.md b/zoom/agent-harness/skills/SKILL.mdsimilarity index 100%rename from zoom/agent-harness/skills/zoom_SKILL.mdrename to zoom/agent-harness/skills/SKILL.md