# @solaqua/skul 中文文档

规范地址：https://npmcn.com/package/%40solaqua/skul/

版本：0\.4\.3
npm 元数据更新时间：2026-11-02T11:35:45.187Z
中文译文更新时间：2026-11-02T13:09:37.581Z
软件包许可：ISC

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40solaqua/skul
原文对照：https://npmcn.com/package/%40solaqua/skul/?lang=original
项目主页：https://skul.solaqua.dev/
源码仓库：https://github.com/sjquant/skul

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，88 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-06-27T08:02:13.503Z
- 最新版本发布：2026-11-02T11:35:44.159Z
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

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

## 安装

```sh
npm install @solaqua/skul
```

也可以使用：`pnpm add @solaqua/skul`、`yarn add @solaqua/skul`、`bun add @solaqua/skul`

## README

![](https://npmcn.com/package/%40solaqua/skul/assets/brand/skul-mark.svg)

# 骷髅党

**你的AI设置，保持在Git之外。**  
将共享的技能、子代理、指令和MCP服务器应用到12个编码工具中，无需输入一行 `git status`.

* * *

每个AI编码工具都希望拥有自己的dotdir： `.claude/`， `.cursor/`， `.codex/`， `.kiro/`提交它们会污染repo和队友的工具选择。在项目之间复制它们会漂移。

Skul在Git仓库（或npm包）中保存一个包，把它写在每个工具需要它的地方，并隐藏结果 `.git/info/exclude`.

```bash
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
```

## 为什么

**不仅仅是技能。** 子代理、命令 `AGENTS.md` / `CLAUDE.md`和MCP服务器放在同一个包中，Skul将它们翻译成每个工具自己的布局和方言。每个项目安装，或全局安装 `--global`.

**没什么可承诺的。** 文件隐藏在 `.git/info/exclude`,从来没有 `.gitignore`。即使是一个团队 `AGENTS.md` 可以毫不费力地把自己的一层放在上面。

**随时撤销。** Skul追踪它写的东西。移除一个包，或者 `skul reset`，你的原始文件就回来了。

## 适用于

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

## 了解更多

-   [开始](https://skul.solaqua.dev/docs/intro) -安装并应用你的第一个bundle
-   [它是如何脱离Git的](https://skul.solaqua.dev/docs/how-it-works) -排除、阴影和注册表
-   [编写bundle](https://skul.solaqua.dev/docs/bundles) -布局，清单，MCP服务器，交叉回购引用
-   [命令](https://skul.solaqua.dev/docs/commands) 和 [支持工具](https://skul.solaqua.dev/docs/tools)

需要Node.js 20+和Git。 [ISC许可](https://npmcn.com/package/%40solaqua/skul/LICENSE).

## 常见问题

### @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 和提交记录判断。