CLI-Anything Skills 目录用 npx skills 一键安装 70 个 Agent 原生 CLI 技能【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anythingskills/目录是 CLI-Anything 仓库面向 AI Agent 的统一技能出口canonicalnpx skillssurface仓库内每个软件 harnessAudacity、Blender、GIMP、FreeCAD、QGIS 等都有一份标准化的SKILL.md技能定义Agent 可通过npx skills add HKUDS/CLI-Anything一键发现、安装并立即使用对应的命令行工具。读完本文你将掌握该目录的布局与双副本机制、npx skills的完整安装用法、SKILL.md的规范结构以及它由skill_generator.py自动生成并与包内副本保持同步的底层原理。skills/ 目录的定位与布局在 CLI-Anything 仓库中skills/是官方规定的技能分发根目录见 skills/README.md。它的职责很单一让仓库内每一个cli-anything-*harness 的技能定义可以被npx skills工具发现、列出并安装。目录布局遵循“一个技能一个子目录、每个子目录内一份SKILL.md”的约定skills/ cli-anything-audacity/SKILL.md cli-anything-blender/SKILL.md ...目前仓库根目录共维护了 70 个技能目录69 个覆盖具体软件的cli-anything-*技能含 cli-anything-audacity/SKILL.md、cli-anything-blender/SKILL.md 等外加 1 个面向 Agent 编排的元技能 cli-hub-meta-skill/SKILL.md。从仓库主文档README.md可以看到这一布局的演进说明每个仓库内 harness 都有一个位于skills/cli-anything-software/SKILL.md的 canonical 副本使整个 monorepo 可以直接被npx skills消费同时安装后的 harness 包仍会在cli_anything/software/skills/SKILL.md携带一份兼容副本保证本地运行时发现能力不受影响。快速上手通过 npx skills 发现与安装技能skills/README.md给出了两条核心用法命令这也是 Agent 或开发者使用整套技能的标准入口# 列出仓库中所有可安装的技能 npx skills add HKUDS/CLI-Anything --list # 安装指定技能-g 全局安装-y 跳过确认 npx skills add HKUDS/CLI-Anything --skill cli-anything-audacity -g -y--list枚举仓库根skills/下全部可用的技能 ID供 Agent 在规划阶段选择--skill skill-id精确安装某一个技能技能 ID 与目录名一一对应例如cli-anything-blender、cli-anything-freecad-g -y分别表示全局安装与自动确认适合非交互式或 Agent 自动化场景。安装完成之后技能对应的 CLI 二进制如cli-anything-audacity通常已在 PATH 中可用Agent 可以直接通过which cli-anything-software探测到工具的存在。SKILL.md 的规范结构frontmatter 触发元数据 正文使用指南skills/下每一份SKILL.md都不是随意的手写文档而是遵循统一规范的自包含技能定义skill-creator 方法论它让 AI 助手可以读文件即会用。YAML Frontmatter触发与描述每个文件头部都有一段 YAML frontmatter包含name与description两个字段。以 skills/cli-anything-audacity/SKILL.md 为例--- name: cli-anything-audacity description: - Command-line interface for Audacity - A stateful command-line interface for audio editing, following the same patterns as the GIMP and Ble... ---name是技能的全局唯一标识description由软件名加 README 导语截断拼接而成用于 Agent 判断这个技能解决什么问题、何时应该触发它。Markdown 正文可复制的实战手册正文部分由模板统一生成通常包含以下固定章节同样可见于 audacity/blender 两份典型 SKILL.md章节内容## Installationpip install cli-anything-software及前置条件Python 3.10、目标软件已安装## Usage/### Basic Commands--help、REPL 模式、新建项目、--json输出等基础命令## Command Groups按业务域分组的命令表Project / Track / Scene / Material / Render 等## Examples可直接复制运行的完整示例## State Management会话状态能力50 级撤销/重做、JSON 项目持久化、会话跟踪## Output Formats人类可读与--json双输出模式## For AI Agents面向 Agent 的编程使用守则## Version版本号以 audacity 技能的命令分组为例正文用表格把全部命令域一次讲清Projectnew/open/save/info/settings/jsonTrackadd/remove/list/set可设置 name、mute、solo、volume、panClipimport/add/remove/trim/split/move/listEffectlist-available/info/add/remove/set/listSelectionset/all/none/infoLabeladd/remove/listMediaprobe/checkExportpresets/preset-info/renderSessionstatus/undo/redo/history每个命令都配有作用说明Agent 无需翻阅完整--help即可生成正确调用。技能正文还专门列出了 AI Agent 编程使用守则始终使用--json获取可解析输出、检查返回码0 成功、非 0 失败、失败时解析 stderr、所有文件操作使用绝对路径、导出后校验产物是否存在。双副本机制canonical 根目录副本与包内兼容副本skills/README.md明确说明了一个关键设计skills/下的SKILL.md是 canonical 仓库根副本而安装后的 harness 包仍会在cli_anything/software/skills/携带兼容副本供本地运行时发现。由此形成了两套并存的路径# 1) 仓库根 canonical 副本npx skills 分发入口 skills/cli-anything-audacity/SKILL.md # 2) 包内兼容副本pip 安装后随包携带 audacity/agent-harness/cli_anything/audacity/skills/SKILL.md通过对仓库的全局搜索可以发现当前共有 67 份包内兼容副本*/skills/SKILL.md与根目录技能一一对应。两副本内容保持一致但职责不同canonical 副本负责面向外部世界——npx skills通过它发现、列出和安装技能兼容副本负责面向安装后的运行时——即使软件包以pip install cli-anything-software单独安装、脱离了 monorepo本地 REPL 依然能找到自己的技能定义。这种monorepo 统一分发 单包自包含的组合正是该机制能同时服务整仓安装与单包安装两种消费场景的原因。REPL 启动横幅中的技能路径解析双副本的优先级在运行时也有体现。从源码看REPL 皮肤模块会在启动横幅中打印技能文件路径见 audacity 的 repl_skin.py其中拼接了npx skills add {_SKILL_SOURCE_REPO} --skill {self.skill_id} -g -y的提示优先显示仓库根 canonical 文件找不到时回退到包内副本。Agent 可以顺着横幅给出的绝对路径直接读取技能文档。SKILL.md 的自动化生成Phase 6.5 与 skill_generator.pySKILL.md并非手工维护而是 CLI harness 构建流水线的固定产出环节Phase 6.5详见 cli-anything-plugin/guides/skill-generation.md。其核心是 cli-anything-plugin/skill_generator.py 中的extract_cli_metadata()第 116 行与generate_skill_file()第 532 行。元数据从哪里来生成器通过静态分析自动提取五类信息全部来自 harness 自身无需额外输入提取项数据来源软件名 / skill 名cli_anything/software/目录名_canonical_skill_name()第 26 行版本号setup.py中的version字段技能导语与系统依赖包内README.md提取标题后首段、apt/brew安装命令命令分组与命令表用ast解析software_cli.py识别 Click 的group/command装饰器及函数 docstring第 248 行示例按软件类型模板化生成新建项目、REPL 会话、导出也就是说只要 harness 的 CLI 源码、README 和 setup.py 是规范的SKILL.md的命令表格、安装说明、示例代码都能自动对齐不会出现文档与实现脱节。输出双落盘generate_skill_file()一次生成两个文件# 1) 仓库根 canonical 副本npx skills 的发现入口 repo_root / skills / metadata.skill_name / SKILL.md # 2) 包内兼容副本随 pip 包分发 harness_path / cli_anything / metadata.software_name / skills / SKILL.md这也解释了上一节双副本机制从何而来——它们是同一份内容由生成器原子化写入的两个位置。为保证pip install后副本随包分发harness 的setup.py需通过package_data显式携带技能文件package_data{ cli_anything.software: [skills/*.md], },模板化渲染正文渲染基于 Jinja2 模板 cli-anything-plugin/templates/SKILL.md.template用{{ skill_name }}、{{ command_groups }}等占位符把提取的元数据填入固定骨架若环境缺少 Jinja2生成器会回退到generate_skill_md_simple()第 427 行的纯字符串实现保证功能不依赖第三方库。手动生成不需要走完整构建流水线时也可以单独运行生成器命令cd cli-anything-plugin python skill_generator.py /path/to/software/agent-harness可选参数-o指定输出路径、-t指定自定义 Jinja2 模板。默认输出即skills/cli-anything-software/SKILL.md与npx skills的发现路径完全一致。CI 同步规则双副本不允许漂移skills/README.md定义了明确的 CI 规则防止 canonical 副本与包内副本长期失步如果某个 harness 在包内维护了深层SKILL.md则它必须同时具备仓库根skills/skill-id/SKILL.md与之匹配未来只把 canonical 技能直接定义在skills/下的新 harness同样合法。第一条规则保证了包内副本存在 → 根目录必有 canonical 副本杜绝了技能能本地发现但无法通过npx skills安装的断裂第二条则给未来更简洁的流程留了空间——新 harness 可以只维护根目录一份不再强制双份。仓库为此配置了根技能校验 CI每次提交都会检查这种对应关系。预览增强技能blender 示例中的特殊章节对于支持实时预览的 harness其SKILL.md会在常规章节之外增加专门的Preview相关段落生成指南见 cli-anything-plugin/guides/skill-generation.md 的 Preview-Capable Harnesses 一节。以 skills/cli-anything-blender/SKILL.md 为例它额外覆盖了生产端命令面preview recipes列出预览配方、preview capture渲染真实预览包、preview live start/push/status/stop启动、推进、查询、停止实时预览会话消费端命令面cli-hub previews inspect/html/watch/open用于查看已生成的预览产物产物语义quick配方会产出真实 Eevee 渲染的hero.png与 Workbench 渲染的workbench.png实时会话以session.json为可变头部、trajectory.json记录追加式的命令到预览历史Agent 使用建议始终用preview capture --json拿到产物路径JSON 只引用文件、不内联图片字节把_bundle_dir视为单次快照长期历史以_session_dir_trajectory_path为准。这段设计的意义在于对 Blender 这类结果是否正确只有看到渲染图才知道的软件Agent 通过预览技能获得真实视觉检查点而不是仅凭 JSON 数据盲猜场景质量。对 Agent 生态的意义把skills/目录放在整个 CLI-Anything 体系中看它是Agent 原生理念的最后一公里上游是 cli-anything-plugin 的八阶段 harness 构建方法论产出统一的、有状态的cli-anything-softwareCLI中游是每个 CLI 自带的SKILL.md技能定义下游则是npx skills add HKUDS/CLI-Anything这一条命令把技能分发到任意 Agent 环境。对于开发者这意味着发现即安装npx skills add HKUDS/CLI-Anything --list即可看到全部 70 个技能无需逐个翻文档技能即文档每份SKILL.md都是自包含的实操手册命令分组、示例、Agent 守则一次讲清双副本保可用无论你从 monorepo 整仓消费还是pip install cli-anything-software单包消费技能定义始终可用生成保一致技能内容由skill_generator.py从源码自动提取并双落盘CI 规则保证两副本不漂移。如果你需要为自己的软件接入这一体系可以沿用 skill_generator.py 与 SKILL.md.template 作为起点规范化 CLI 源码Click 命令分组 docstring、维护 README 与 setup.py、运行生成器并保证根目录 canonical 副本与包内副本同步提交即可让你的软件同样被 Agent读得懂、装得上、用得好。【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考