Skip to content

[Bug]: install_skill 写入的文件结构不符合通用 skill 命名/组织规范 #3334

Description

@CVEngineer66

Version line

v2 — Go rewrite (1.x), main-v2 (active development)

Exact version

dev

What happened?

描述

使用 install_skill 工具安装 GSAP 官方 AI skills 时,它把每个 skill 写成了单个 <name>.md 文件,而不是业界通用的文件夹 + SKILL.md 结构。

对比

业界通用规范(GSAP 仓库、Claude Code、Cursor 等):

skills/
  gsap-core/
    SKILL.md
  gsap-timeline/
    SKILL.md
  gsap-plugins/
    SKILL.md
  ...

install_skill 实际写入的

.reasonix/skills/
  gsap-core.md
  gsap-timeline.md
  gsap-plugins.md
  ...

问题

  1. 命名不合规—skill 文件名是 gsap-core.md 而不是 gsap-core/SKILL.md
  2. 不兼容—如果其他 agent(Claude Code、Cursor 等)也要读取同一份 skill 目录,它们不认识这种平铺格式
  3. 无法用 install_source 批量安装install_source 不接受多 skill 仓库 URL,只能逐个手动 fetch → install_skill,而逐个安装后结构也被拍平了

建议

应当采用 <name>/SKILL.md 的文件夹结构,以符合通用 skill 规范,并与其他 AI agent 生态兼容。

此外我认为这个工具并不好用,与还未合并的PR#3292 中的install_source 安装器(URL/本地/MCP/skill)有冲突,同时开发或者创建一个新的 skill(非安装),更适合其他 AI Agent 常用的skill-creator工具

Steps to reproduce

安装一个任意 skill 就可以复现

OS / platform

MacOS

Relevant logs or output

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingmacosmacOS-specificskillsSkill system (internal/skill, internal/tool)v2Go rewrite (1.x) — main-v2 branch, active development

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions