菜单
管理 Agent Skills 的 j-skills CLI 操作指南，基于本机已安装的 0.4.4 命令面。当用户要链接本地 Skill、安装到 Claude Code/Codex/Cursor 等环境、卸载、查看安装状态或管理 registry 时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
在需要打包、签名、OTA、APK/IPA、GitHub Release、商店提交、部署、回滚或验活时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它核对具体渠道授权，可复用用户明确记录的项目级 preview OTA 持续授权并在验证通过后自动发布；未获授权只做预检。
把自然语言 App 需求、模块说明和参考截图一路推进到经验证的代码与当次授权交付；用于需要长时间自主开发、持续排障和跨上下文恢复的移动端或跨端 App 任务。它不固定技术栈、阶段或交付形式，也不会把无人值守理解为远端发布授权。
在需要与生产者分离的独立评审、复核、验收，或对 App 方案、UI、代码、体验或交付准备度做质量判断时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它只做只读评判并绑定真实证据，不创建或修改产物，也不做第一方定位根因或直接改代码。
在设计、开发或交付 App 时按需参考 Happy/Paws 经验，包括移动端架构、React Native/Expo 取舍、验证、OTA、安装包与 Release 边界。用于用户明确要求参考 Happy/Paws，或当前问题与这些真实工程经验高度匹配时；它只提供上下文，不是 App Workflow，也不强制复制 Happy 的技术栈。
在需要创建、修改、重构、修复 App 代码，或只读诊断崩溃、定位根因、给出候选补丁时使用；支持独立窄任务，也支持作为 app-flow 的当前行动。它不做产品调研、原型/设计、独立评审或打包发布，除非当前行动本身就是改代码。
作为 self-learning 的 HyperFrames 产出能力，自主学习本地教学音视频或公开视频链接，把教程讲授的方法、可观察动效和屏幕代码转成有证据、可恢复、可渲染的 HyperFrames Demo，并记录实际使用的内容、Skills、工具与可复用经验。仅在 self-learning 调用，或用户明确要求从教学素材制作 HyperFrames Demo 时使用；普通学习任务不要单独触发。
| name | j-skills |
| description | 管理 Agent Skills 的 j-skills CLI 操作指南，基于本机已安装的 0.4.4 命令面。当用户要链接本地 Skill、安装到 Claude Code/Codex/Cursor 等环境、卸载、查看安装状态或管理 registry 时使用。 |
j-skills 用于把本地 Skill 目录注册到全局 registry，再安装到指定 Agent 环境。
j-skills --version 和对应子命令的 --help，以当前二进制为准。--json 获取可审计输出。jacky-skills 仓库时直接使用根目录 ./install.sh。npm install -g @wangjs-jacky/j-skills@latest --registry=https://registry.npmjs.org/
j-skills --version
Apple Silicon Mac 应先确认 node -p 'process.arch' 输出 arm64。
# 链接当前目录
j-skills link
# 链接指定 Skill 目录
j-skills link /path/to/skill
# 列出已链接 Skill
j-skills link --list --json
# 取消链接
j-skills link --unlink skill-name --json
link 每次只接受一个 Skill 目录。要批量处理时逐个调用，或使用仓库 install.sh。
Linux 等大小写敏感文件系统上，0.1.0 可能因检查小写
skill.md而拒绝标准SKILL.md。仓库install.sh已内置临时兼容链接并在执行后清理。
# 安装到当前项目
j-skills install skill-name --env claude-code,codex --json
# 安装到用户全局
j-skills install skill-name --global --env claude-code,codex --json
--env 接收逗号分隔的环境名。不传 --env 时会进入交互式多选。
# 卸载当前项目中的 Skill
j-skills uninstall skill-name --yes --json
# 卸载用户全局 Skill
j-skills uninstall skill-name --global --yes --json
j-skills list --local --json
j-skills list --global --json
j-skills list --all --json
j-skills list --search keyword --json
j-skills config:list
j-skills config:set key value
j-skills config:reset
j-skills config:add-registry name https://example.com/registry.json
j-skills config:registries
j-skills config:use name
@wangjs-jacky/j-skills 已改为 GitHub Actions 自动发布。修改 CLI 源码后，不要在本机执行 npm publish。
jacky-skills-package/packages/cli/package.json 的版本号。main。v* tag，例如 v0.4.4。.github/workflows/publish.yml 自动测试、typecheck、build、校验 CLI 自报版本，并通过 npm Trusted Publishing / OIDC 发布。packages/cli/src/index.ts 从 package.json 读取版本号，禁止再写死 const VERSION = 'x.y.z'。2026-07-12 已验证 CI 可发布 @wangjs-jacky/j-skills@0.4.4；后续不需要本机 npm login、不需要长期 NPM_TOKEN。
# 1. 验证目录
test -f /path/to/skill/SKILL.md
# 2. 链接
j-skills link /path/to/skill --json
# 3. 安装
j-skills install skill-name --global --env claude-code,codex --json
# 4. 核验
j-skills link --list --json
j-skills list skill-name --json
Skill not found：先运行 j-skills link --list --json，确认 Skill 已链接。j-skills list skill-name --json 检查目标环境路径，必要时重启 Agent 会话。j-skills <command> --help，不从旧文档猜测。npm publish 报 ENEEDAUTH：不要在本机发布。检查是否已推送匹配 packages/cli/package.json 的 v* tag，并查看 GitHub Actions 的 Publish j-skills to npm workflow。