@solaqua/skul

中文文档
0.4.3发布于 2026/11/02ISCTypeScriptCommonJS构建来源已验证

Your AI setup, kept out of Git: apply shared skills, subagents, instructions, and MCP servers to your coding tools.

原始使用文档
文档目录3 节
  1. Why
  2. Works with
  3. Learn more

skul

Your AI setup, kept out of Git.
Apply shared skills, subagents, instructions, and MCP servers to 12 coding tools — without a single line in git status.


Every AI coding tool wants its own dotdir: .claude/, .cursor/, .codex/, .kiro/… Committing them pollutes the repo and your teammates' tool choices. Copying them between projects drifts.

Skul keeps one bundle in a Git repo (or npm package), writes it where each tool expects it, and hides the result with .git/info/exclude.

npm install --global @solaqua/skul

skul add sjquant/ghosts writing    # fetch a public example, write, hide
skul status                        # what's applied, where
skul apply                         # same setup in a new worktree
skul remove writing                # remove it, restore your originals

Why

More than skills. Subagents, commands, AGENTS.md / CLAUDE.md, and MCP servers go in the same bundle, and Skul translates each into every tool's own layout and dialect. Install per project, or globally with --global.

Nothing to commit. Files are hidden through .git/info/exclude, never .gitignore. Even a team-committed AGENTS.md can take your own layer on top with no diff.

Undo anytime. Skul tracks what it wrote. Remove a bundle, or skul reset, and your original files come back.

Works with

Claude Code · Cursor · Codex · OpenCode · GitHub Copilot · Kiro · Antigravity · Grok Build · Qwen Code · Cline · Kimi Code CLI · ZCode

Learn more

Requires Node.js 20+ and Git. ISC licensed.

版本与发布记录

@solaqua/skul 共发布 19 个版本,首次发布于 2026/06/27;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.3latest2026/11/021 天前
0.4.22026/10/294 天前
0.4.12026/10/295 天前
0.4.02026/10/249 天前
0.3.22026/10/2410 天前
0.3.12026/10/1617 天前

关于 @solaqua/skul 的常见问题

@solaqua/skul 是什么?

您的AI设置,保存在Git之外:将共享技能、子代理、指令和MCP服务器应用到您的编码工具中。

如何安装 @solaqua/skul?

在项目目录运行 npm install @solaqua/skul,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 skul,可以用 npx skul 直接运行。

@solaqua/skul 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@solaqua/skul 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@solaqua/skul 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@solaqua/skul 可以商用吗?

@solaqua/skul 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@solaqua/skul 还在维护吗?

最新版本 0.4.3 发布于 2026/11/02(1 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/06/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。