Skip to content

docs: correct skills CLI install path to the curated /skills subpath#51

Merged
os-zhuang merged 1 commit into
mainfrom
claude/third-party-skills-review-2r4sj1
Jul 21, 2026
Merged

docs: correct skills CLI install path to the curated /skills subpath#51
os-zhuang merged 1 commit into
mainfrom
claude/third-party-skills-review-2r4sj1

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

概述

第三方开发者视角的 skills 审核(framework#3374 同批次)发现 objectos 文档在 4 组页面 × 7 个语言版本(共 49 处)把安装命令写成仓库根路径:

npx skills add objectstack-ai/framework   # ❌ 根路径

skills CLI 的目录遍历会因此把 framework 仓库内部的 agent skills(.claude/skills/ 等)一并装进用户项目 —— framework 侧的 template-consistency 测试(#3101)已把 /skills 明确定为发布边界,但 objectos 文档从未同步。全部改为:

npx skills add objectstack-ai/framework/skills

其他修复(reference/skills-cli.mdx,全语言版本)

  • 删除虚构的固定版本语法npx skills add <org>/<repo>@<ref> 与示例 @v5.0.0 —— skills CLI 没有 @<git-ref> 源格式(@skills use 中是选 skill 名),且 framework 仓库不存在 v5.0.0 tag(实际只有 v0.1.0)。替换为 CLI 官方文档支持的 URL 形式 https://github.com/<org>/<repo>/tree/<ref>/<path>
  • 删除不实注释 “pulls latest matching the spec version range” —— CLI 没有任何 spec 版本范围匹配逻辑。
  • 更新 Claude Code 写入路径:当前 CLI 写入通用目录 .agents/skills/<name>/ 并将 .claude/skills/<name> 软链过去(已在真实脚手架项目中实测验证)。

涉及文件

quickstartbuild/ai-skillsbuild/agentsreference/skills-cli 的 en / zh-Hans / de / es / fr / ja / ko 版本,共 28 个文件、49 处替换。

🤖 Generated with Claude Code

https://claude.ai/code/session_012Kj2MJEPXoUXC4LiC3XYJc


Generated by Claude Code

The quickstart, IDE-skills, agents, and skills-cli pages (all locales)
advertised `npx skills add objectstack-ai/framework`, which points the
skills CLI at the repo root — its catalog walk then also discovers
repo-internal skills outside the curated `skills/` directory
(framework#3101 established /skills as the hard publish boundary).

Also in the skills-cli reference:
- replace the `<org>/<repo>@<ref>` pin syntax and the `@v5.0.0`
  example — the skills CLI has no @<git-ref> source form and the
  framework repo has no v5.0.0 tag; use the documented
  https://github.com/<org>/<repo>/tree/<ref>/<path> URL form instead
- drop the 'pulls latest matching the spec version range' comment
  (the CLI does no spec-version matching)
- update the Claude Code row: current CLI writes universal
  .agents/skills/<name>/ and symlinks .claude/skills/<name> to it

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012Kj2MJEPXoUXC4LiC3XYJc
@os-zhuang
os-zhuang marked this pull request as ready for review July 21, 2026 00:57
@os-zhuang
os-zhuang merged commit 70e111f into main Jul 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants