mcpField
M
my-first-skill

my-first-skill

github.com/numman-aliAgent 工作流10.8k52 次安装40 周前更新
代码仓库

关于 my-first-skill

面向编码 Agent 的示例技能，展示 Anthropic SKILL.md 格式和渐进式披露，并说明如何组织操作指引与配套资源。

主要功能

  1. 01SKILL.md 结构说明
  2. 02YAML frontmatter 示例
  3. 03渐进式披露方法
  4. 04配套资源组织指引

适用场景

  1. 01学习技能的结构
  2. 02测试 OpenSkills 加载器
  3. 03整理详细指引和资源

安装

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

$npx skills add https://github.com/numman-ali/openskills --skill my-first-skill

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

附带文件references/skill-format.md

详细介绍

我的第一个技能

这是一个示例技能，演示 Anthropic SKILL.md 格式。

用途

此技能展示如何使用渐进式披露，为 AI 编码 Agent 编写结构化的操作指南。

适用场景

在以下情况下加载此技能：

  • 了解技能的工作方式
  • 测试 OpenSkills 加载器
  • 了解 SKILL.md 格式

说明

创建技能：

  1. 创建目录：mkdir my-skill/
  2. 添加包含 YAML 前置元数据的 SKILL.md： 
    ---
name: my-skill
description: When to use this skill
---
  3. 使用祈使形式编写说明（而非第二人称）
  4. 根据需要引用随附资源

随附资源

有关 SKILL.md 规范的详细信息：

请参阅 references/skill-format.md

最佳实践

  • 使用祈使式或不定式形式编写：“要执行 X，请执行 Y”
  • 不要使用第二人称：避免使用“You should...”
  • 将 SKILL.md 控制在 5,000 个词以内
  • 将详细内容移至 references/
  • 使用 scripts/ 存放可执行代码
  • 使用 assets/ 存放模板和输出文件

资源解析

加载此技能时，会提供基础目录：

Base directory: /path/to/my-first-skill

相对路径以基础目录为起点解析：

  • references/skill-format.md → /path/to/my-first-skill/references/skill-format.md
  • scripts/helper.sh → /path/to/my-first-skill/scripts/helper.sh

评论

支持 Markdown