{"_id":"@dwxxzxj/agent-skills","name":"@dwxxzxj/agent-skills","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@dwxxzxj/agent-skills","version":"0.1.0","description":"Install and update skills from a private personal Agent Skills repository.","type":"module","bin":{"agent-skills":"bin/agent-skills.mjs"},"scripts":{"test":"node --test","check:package":"node scripts/check-package.mjs","prepublishOnly":"npm test && npm run check:package"},"engines":{"node":">=22.20.0"},"license":"UNLICENSED","publishConfig":{"access":"public"},"gitHead":"4dec698fc1831d06d52ac3a17c979c0222d788da","_id":"@dwxxzxj/agent-skills@0.1.0","_nodeVersion":"24.14.1","_npmVersion":"11.18.0","dist":{"integrity":"sha512-4u+bZft/gPXWfHoBOKnlq6oyYmOU7tZVcg+EmqG+aHXxa58lZXYKKgL9qEzkpiL8eAxPeTTpk8PIDkPJvVOYhw==","shasum":"3d749c35138a181ad6e1dc1381b4a85fd3a05957","tarball":"https://registry.npmjs.org/@dwxxzxj/agent-skills/-/agent-skills-0.1.0.tgz","fileCount":13,"unpackedSize":43959,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDliwa/dDET7FzR3gQfhDUNi6oZMrN5Nsz7uzI6iJFWTQIgPCPTgMDwD8zI36jPJo4ZjxnOf9TazLCfeHQSBR043f8="}]},"_npmUser":{"name":"dwxxzxj","email":"dwxx.zxj@gmail.com"},"directories":{},"maintainers":[{"name":"dwxxzxj","email":"dwxx.zxj@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-skills_0.1.0_1784907600620_0.20371480649163698"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-24T15:40:00.469Z","0.1.0":"2026-07-24T15:40:00.782Z","modified":"2026-07-24T15:40:00.995Z"},"maintainers":[{"name":"dwxxzxj","email":"dwxx.zxj@gmail.com"}],"description":"Install and update skills from a private personal Agent Skills repository.","license":"UNLICENSED","readme":"# `@dwxxzxj/agent-skills`\n\n从私有 GitHub 仓库 `dwxxzxj/agent-skills` 安装和更新个人 Agent\nSkills。安装器本身是公开 npm 包，但 skill 源码始终保留在私有仓库中。\n\n支持原生 macOS、Linux 和 Windows。\n\n## 准备\n\n安装下列工具：\n\n- Node.js 22.20.0 或更高版本\n- npm / npx\n- Git\n- [GitHub CLI](https://cli.github.com/)\n\n然后让 GitHub CLI 登录有权读取私有仓库的账号：\n\n```sh\ngh auth login\nnpx @dwxxzxj/agent-skills@latest doctor\n```\n\n无人值守环境可以通过 GitHub CLI 原生支持的 `GH_TOKEN` 或\n`GITHUB_TOKEN` 传入凭据。安装器不会启动登录流程，也不会保存 token。\n\n## 安装\n\n```sh\n# 通用 + Codex 专用\nnpx @dwxxzxj/agent-skills@latest install codex\n\n# 通用 + Claude Code 专用\nnpx @dwxxzxj/agent-skills@latest install claude\n\n# 两套都安装\nnpx @dwxxzxj/agent-skills@latest install all\n```\n\nCodex skill 会复制到 `~/.agents/skills`，Claude Code skill 会复制到\n`~/.claude/skills`。如果设置了 `CLAUDE_CONFIG_DIR`，则使用其中的\n`skills` 子目录。\n\n## 日常使用\n\n```sh\nnpx @dwxxzxj/agent-skills@latest update\nnpx @dwxxzxj/agent-skills@latest status\nnpx @dwxxzxj/agent-skills@latest doctor\nnpx @dwxxzxj/agent-skills@latest uninstall\n```\n\n`update` 只执行 fast-forward Git 拉取，然后重新部署上次安装的 profile。\n它不会 reset、merge 或覆盖有本地修改的私有仓库。\n\n如果目标 skill 与已记录版本不一致，命令会在写入前停止。确认需要替换时：\n\n```sh\nnpx @dwxxzxj/agent-skills@latest update --force\n```\n\n`--force` 会先备份冲突内容；保留最近 5 组备份。\n\n卸载默认只移除由本安装器记录和管理的 skill。若要同时移除经过校验的私有\n仓库 clone 和备份：\n\n```sh\nnpx @dwxxzxj/agent-skills@latest uninstall --purge\n```\n\n## 本地数据\n\n私有仓库默认 clone 到：\n\n- macOS / Linux：`~/.local/share/personal-agent-skills`\n- Windows：`%LOCALAPPDATA%\\personal-agent-skills`\n\n可以用绝对路径环境变量 `PERSONAL_AGENT_SKILLS_HOME` 覆盖。部署状态、临时\nstaging 和备份保存在 clone 内的 `.installer-state/`，其中不保存凭据。\n\n安装器固定调用 `skills@1.5.20` 的全局 copy 模式，避免 Windows\n软链接权限差异，也让每台电脑获得独立、可检查的 skill 副本。\n\n如需临时验证未来版本，可以把\n`PERSONAL_AGENT_SKILLS_CLI_VERSION` 设为一个完整版本号。该入口属于实验\n用途，命令会明确提示正在使用未经本仓库测试的版本。\n","readmeFilename":"README.md","_rev":"1-0cf3e0dd5e69e7f76e472f48507fd275"}