Menu
管理 Agent Skills 的 j-skills CLI 操作指南，基于本机已安装的 0.4.4 命令面。当用户要链接本地 Skill、安装到 Claude Code/Codex/Cursor 等环境、卸载、查看安装状态或管理 registry 时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
在需要打包、签名、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。