内容
# Qlik 智能代理技能
这是 Qlik 的公共、开源中心，用于存放 AI 代理技能 - 可重复使用的技能和 Claude 插件，它们通过 Qlik 特有的专业知识扩展 AI 代理。任何人都可以贡献；请参见下面的[贡献技能](#贡献技能)。
这里的技能适用于 Anthropic（Claude 和 Claude Code）、OpenAI（ChatGPT、Codex）、GitHub Copilot、Cursor、Gemini CLI 等 20 多种其他支持开放[代理技能标准](https://agentskills.io)的工具。
## 什么是代理技能？
代理技能是一组指令、脚本和参考资料，AI 代理按需加载。 与其在每次对话中重复上下文，不如将专业知识打包一次，让代理自动发现和应用。
可以将技能视为新入职员工的入职指南 - 它告诉代理在特定环境中该做什么、何时做以及如何正确地做。[SKILL.md 格式](https://agentskills.io/specification)是一种开放标准，因此在此处编写的技能在每个兼容工具中都以相同的方式工作。
## 此仓库的内容
```
agentic-skills/
├── official/ # Qlik 拥有和维护的技能
│ ├── skills/
│ │ └── README.md
│ └── .claude-plugin/plugin.json
├── community/ # 客户和合作伙伴贡献
│ ├── skills/
│ │ └── README.md
│ └── .claude-plugin/plugin.json
├── spec/
│ └── README.md
├── template/skill # 新技能的启动模板
│ ├── README.md
│ └── SKILL.md
├── scripts/ # CI 验证脚本（SKILL.md 规范 + 插件清单检查）
├── .github/workflows/ # CI：在相关文件更改时运行上述脚本
├── .claude-plugin/
│ └── marketplace.json
├── package.json / pnpm-lock.yaml # 用于验证脚本的 Node 工具
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── NOTICE
└── README.md
```
### 官方文件夹
由 Qlik 员工拥有和维护的技能，在合并前由官方维护团队审查。 这些是与 Qlik Cloud 合作的通用方式，通过 AI 代理。
### 社区文件夹
由 Qlik 客户、合作伙伴和开发者社区贡献的技能和 Claude 插件。 每个社区技能都经过自动安全扫描和质量审查后才被合并。
### 插件
Claude Code 插件，将每个层级的技能（`official/`、`community/`）打包成一个可安装的单元，通过 Claude 的插件市场。 插件格式支持将代理、钩子、斜杠命令和 MCP 服务器配置与技能捆绑在一起，但底层技能本身不受特定插件打包方式的影响。
## 安装技能
使用 [`npx skills` CLI](https://skills.sh) 安装技能 - 无需设置。
```bash
# 从此仓库浏览和安装所有内容
npx skills add qlik-oss/agentic-skills
# 安装特定技能
npx skills add qlik-oss/agentic-skills --skill <技能名称>
# 安装到特定代理
npx skills add qlik-oss/agentic-skills --skill <技能名称> -a claude-code
# 一次安装到所有检测到的代理
npx skills add qlik-oss/agentic-skills --agent '*' --skill <技能名称>
```
CLI 自动检测已安装的 AI 工具，并将技能文件放在每个工具的正确目录中。
### 手动安装
如果您更喜欢手动安装，请将技能文件夹克隆或复制到代理的技能目录中：
| 代理 | 项目范围 | 全局范围 |
|---|---|---|
| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
| OpenAI Codex | `.agents/skills/` | `~/.codex/skills/` |
| Cursor | `.claude/skills/` | `~/.claude/skills/` |
| Gemini CLI | `.claude/skills/` | `~/.claude/skills/` |
| VS Code / Copilot | `.github/skills/` | — |
| JetBrains Junie | `.junie/skills/` | `~/.junie/skills/` |
### Claude Code 插件市场
Claude Code 用户还可以通过插件系统安装，每个层级的技能都打包成一个可安装的插件：
```
/plugin install qlik-cloud-skills@qlik-cloud-skills
/plugin install qlik-cloud-community-skills@qlik-cloud-skills
```
## 可用技能
参见 [`official/skills/`](./official/skills/) 获取当前官方技能列表，参见 [`community/skills/`](./community/skills/) 获取社区贡献。
## 兼容性
此仓库遵循开放的[代理技能规范](https://agentskills.io)。 技能适用于所有兼容工具 - 无需每个工具的特定配置。
| 工具 | 支持 |
|---|---|
| Claude Code (Anthropic) | ✓ |
| OpenAI Codex | ✓ |
| GitHub Copilot / VS Code | ✓ |
| Cursor | ✓ |
| Gemini CLI | ✓ |
| JetBrains Junie | ✓ |
| Goose (Block) | ✓ |
| OpenCode | ✓ |
| Amp | ✓ |
## 贡献技能
欢迎社区贡献。 最快捷的方式是使用 `skill-creator` 技能来搭建您的 SKILL.md，然后打开一个拉取请求。
```bash
# 使用代理启动新的技能
npx skills add anthropics/skills --skill skill-creator
```
参见 [CONTRIBUTING.md](./CONTRIBUTING.md) 获取完整指南 - 包括信任层模型、规范约束、PR 检查清单和适用于所有贡献的安全规则。
## 在本地验证技能
在打开 PR 之前，运行官方规范验证器：
```bash
uvx --from git+https://github.com/agentskills/agentskills#subdirectory=skills-ref \
skills-ref validate community/skills/your-skill-name/
```
## 相关资源
- [代理技能开放标准](https://agentskills.io) — 规范和参考
- [Anthropic 官方技能](https://github.com/anthropics/skills) — 文档、编码和生产力技能
- [skills.sh](https://skills.sh) — 社区目录和安装排行榜
- [Qlik 开发者门户](https://qlik.dev) — Qlik API 和平台文档
## 许可证
此仓库中的所有技能均在 [Apache 2.0](./LICENSE) 下许可，除非在技能的 SKILL.md 前言中另有说明。
## 代码行为准则
该项目遵循 [Qlik 的行为准则](./CODE_OF_CONDUCT.md)。 请在贡献之前阅读。
MCP 市场