mcpField
C
create-skill

create-skill

github.com/jasonharmongitAgent 工作流38 次安装
代码仓库

关于 create-skill

这是一项指导编写 SKILL.md 格式 Agent 技能的技能，说明必需的 frontmatter、目录布局及精简指令的原则，面向技能作者。

主要功能

  1. 01定义 YAML frontmatter 字段
  2. 02组织技能文件与目录
  3. 03遵循精简编写原则

适用场景

  1. 01起草新的 SKILL.md 文件
  2. 02规划参考文档和示例文件
  3. 03精简 Agent 上下文中的指令

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jasonharmongit/jh-skills --skill create-skill

安装后在 Claude Code 中输入/create-skill确认已加载。

详细介绍

创建 Skill

Skill 的组成

Frontmatter

每个 SKILL.md 文件都以 YAML frontmatter 开头：

---
name: your-skill-name
description: Brief high-level description of what this skill does.
disable-model-invocation: true
---
  • name：Skill 的 kebab-case 标识符
  • description：用一句话概述 Skill 的功能。不要包含 Skill 的具体工作方式、调用时机或触发词。
  • disable-model-invocation：默认添加 disable-model-invocation: true，这样只有在明确指定时才会加载 Skill。

Skill 文件结构

目录布局

Skill 以包含 SKILL.md 文件的目录形式存储：

skill-name/
├── SKILL.md              # Required - main instructions
├── reference.md          # Optional - detailed documentation
├── examples.md           # Optional - usage examples
└── scripts/              # Optional - utility scripts
    ├── validate.py
    └── helper.sh

核心编写原则

1. 简洁为要

上下文窗口由对话历史、其他 Skill 和请求共享。每个 token 都在争夺空间。

默认假设：Agent 已经很聪明。只添加它尚不了解的上下文。

逐条审视信息：

  • “Agent 真的需要这段解释吗？”
  • “我可以假定 Agent 知道这些吗？”
  • “这一段值得占用这些 token 吗？”

评论

支持 Markdown