开放的AI代理技能集合——可重用、框架无关的 SKILL.md 包,适用于Claude Code及其他应用。用npx技能安装,添加水晶/技能
概览
AI代理技能的开放集合——可重用、不依赖框架的 SKILL.md 包,适用于Claude Code及兼容代理。 A 是一个自包含的目录,带有一个 SKILL.md 文件。它以任何支持 SKILL.md 的代理都能执行的方式打包“如何做 X”,没有共享运行时,也没有全局状态。复制它、分支它、在项目间移动它——它就是能正常运行。 技能遵循三层渐进披露模型:轻量级前置件(用于激活)、有界实体(用于执行)和可选引用(按需加载)。请参见 HUMAN.md 设计理念。 更多内容即将发布。想添加一个吗?跳转到贡献。 安装后,使用插件命名空间调用:/crystools-skills: 。 欢迎贡献——新技能、改进、漏洞修复、文档。从这里开始: 1. 阅读 CONTRIBUTING.md。2. 对于新技能,先开启新技能提案以对应范围。3. 复制技能/_template/作为起点。4. 创建PR;CI会自动验证 SKILL.md 结构。
概述(AI 翻译)
AI代理技能的开放集合——可重用、无框架限制的 SKILL.md 包,适用于Claude Code及兼容代理。
目录
- 什么是技能?
- 可用技能
- 安装
- 更新
- 贡献
- 项目布局
- 文献
- 许可证
什么是技能?
skill 是一个自包含的目录,带有一个 SKILL.md 文件。它以任何支持 SKILL.md 的代理都能执行的方式打包“如何做 X”,无需共享运行时,也无需全局状态。复制它、分支它、在项目间移动——它就是能正常运行。
技能遵循三层渐进披露模型:轻量级前置件(用于激活)、有界实体(用于执行)和可选引用(按需加载)。请参见 HUMAN.md 设计理念。
可用技能
| 技能 | 描述 | 文档 |
|---|---|---|
| 技能优化器 | AI代理技能的Kaizen——观察执行,诊断摩擦,提出具体 SKILL.md 改进建议 | 阅读说明 |
| 技能映射 | 映射、检查和管理相互关联的Markdown技能、代理和文档集合——图浏览器 + CLI + 可选的LLM层。存在于自己的仓库中。 | README |
还有更多。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
crystools-skills
Open collection of AI agent skills — reusable, framework-agnostic SKILL.md packages for Claude Code and compatible agents.
Table of Contents
What’s a skill?
A skill is a self-contained directory with a SKILL.md file. It packages “how to do X” in a way any SKILL.md-aware agent can execute, with no shared runtime and no global state. Copy it, fork it, move it between projects — it just works.
Skills follow a three-layer progressive disclosure model: lightweight frontmatter (for activation), a bounded body (for execution), and optional references (loaded on demand). See HUMAN.md for the design philosophy.
Available skills
| Skill | Description | Docs |
|---|---|---|
| skill-optimizer | Kaizen for AI agent skills — observes execution, diagnoses friction, proposes concrete SKILL.md improvements | README |
| skill-map | Map, inspect and manage collections of interconnected Markdown skills, agents and docs — graph explorer + CLI + optional LLM layer. Lives in its own repo. | README |
More coming. Want to add one? Jump to Contributing.
Install
# All skills via Claude Code plugin
claude /plugin install crystian/skills
# All skills via npx
npx skills add crystian/skills
# A single skill
npx skills add crystian/skills --skill skill-optimizer
Once installed, invoke with the plugin namespace: /crystools-skills:.
Update
npx skills check # check for updates
npx skills update # update all
npx skills add crystian/skills # reinstall latest
Contributing
Contributions are welcome — new skills, improvements, bug fixes, docs. Start here:
- Read CONTRIBUTING.md.
- For a new skill, open a New skill proposal first to align on scope.
- Copy
skills/_template/as your starting point. - Open a PR; CI validates SKILL.md structure automatically.
Quick start for a new skill:
cp -r skills/_template skills/my-new-skill
# edit skills/my-new-skill/SKILL.md and README.md
Project layout
.claude-plugin/
plugin.json # plugin manifest
.github/
ISSUE_TEMPLATE/ # issue forms
推荐工具
换一个关键词,或者移除筛选条件。
安装
npx skillfish add crystian/skills