Skill 创建指南
- Repo stars 832
- Author repo bk-bcs
Skill 创建指南
⚠️ 核心规则
- SKILL.md ≤ 2KB: 超出内容必须移到
references/ - 必须包含 Front Matter: id, name, category, description, tags, updated_at
- 按需加载引导: 详细内容通过
skill://URI 引用 - 存放位置: 所有 skill 必须放在
bkui-knowledge/knowledge/skills/目录下
快速开始
cp -r knowledge/skills/.template knowledge/skills/your-skill-id
vim knowledge/skills/your-skill-id/SKILL.md
bash scripts/validate-skill.sh your-skill-id
详细步骤: skill://bk-skill-creator/references/quick-start.md
📦 按需加载资源
| 资源 | URI |
|---|---|
| 快速开始 | skill://bk-skill-creator/references/quick-start.md |
| 目录结构 | skill://bk-skill-creator/references/structure-guide.md |
| 常见错误 | skill://bk-skill-creator/references/common-mistakes.md |
| 检查清单 | skill://bk-skill-creator/references/skill-checklist.md |
| 写作技巧 | skill://bk-skill-creator/references/writing-tips.md |
📦 可用资源
skill://bk-skill-creator/references/common-mistakes.mdskill://bk-skill-creator/references/quick-start.mdskill://bk-skill-creator/references/skill-checklist.mdskill://bk-skill-creator/references/structure-guide.mdskill://bk-skill-creator/references/writing-tips.md
根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载
- Fluxly category
- Engineering · skill · knowledge · template
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @TencentBlueKing · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
The current SKILL.md does not define a fixed output example. SKILL.md ≤ 2KB: 超出内容必须移到 references/ 必须包含 Front Matter: id, name, category, description, tags, updatedat 按需加载引导: 详细内容通过 skill:// URI 引用
详细步骤: skill://bk-skill-creator/references/quick-start.md
资源 · URI 快速开始 · skill://bk-skill-creator/references/quick-start.md 目录结构 · skill://bk-skill-creator/references/structure-guide.md
skill://bk-skill-creator/references/common-mistakes.md skill://bk-skill-creator/references/quick-start.md skill://bk-skill-creator/references/skill-checklist.md
# Skill 创建指南
## ⚠️ 核心规则
1. **SKILL.md ≤ 2KB**: 超出内容必须移到 `references/`
2. **必须包含 Front Matter**: id, name, category, description, tags, updated_at
3. **按需加载引导**: 详细内容通过 `skill://` URI 引用
4. **存放位置**: 所有 skill 必须放在 `bkui-knowledge/knowledge/skills/` 目录下
## 快速开始
```bash
cp -r knowledge/skills/.template knowledge/skills/your-skill-id
vim knowledge/skills/your-skill-id/SKILL.md
bash scripts/validate-skill.sh your-skill-id
```
详细步骤: `skill://bk-skill-creator/references/quick-start.md`
## 📦 按需加载资源
| 资源 | URI |
|-----|-----|
| 快速开始 | `skill://bk-skill-creator/references/quick-start.md` |
| 目录结构 | `skill://bk-skill-creator/references/structure-guide.md` |
| 常见错误 | `skill://bk-skill-creator/references/common-mistakes.md` |
| 检查清单 | `skill://bk-skill-creator/references/skill-checklist.md` |
| 写作技巧 | `skill://bk-skill-creator/references/writing-tips.md` |
---
## 📦 可用资源
- `skill://bk-skill-creator/references/common-mistakes.md`
- `skill://bk-skill-creator/references/quick-start.md`
- `skill://bk-skill-creator/references/skill-checklist.md`
- `skill://bk-skill-creator/references/structure-guide.md`
- `skill://bk-skill-creator/references/writing-tips.md`
> 根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载 Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> ⚠️ 核心规则 → 快速开始 → 📦 按需加载资源 → 📦 可用资源
terms -> SKILL.md ≤ 2KB · 必须包含 Front Matter · 按需加载引导 · 存放位置
files/cmd -> references/ · skill:// · bkui-knowledge/knowledge/skills/ · skill://bk-skill-creator/references/quick-start.md · skill://bk-skill-creator/references/structure-guide.md · skill://bk-skill-creator/references/common-mistakes.md · skill://bk-skill-creator/references/skill-checklist.md · skill://bk-skill-creator/references/writing-tips.md
body sha256 -> e83308841610
Decide Fit First
Design Intent
How To Use It
Boundaries And Review