MMCPMarkets
NS

nangeplus/skilltutorial

API development
8 stars Quality 49 Trend 20MIT
Repository Install

本系列按 认知 → 编写 → 实战 → 交付闭环 串起一条可走完的路径： 认知 建立 Skill 的定位与运行机制（01_什么是Skill）； 编写 系统讲清需求澄清、description、SKILL.

Overview

系统讲清需求澄清、description、SKILL.md 结构、渐进式披露与避坑（02_如何高质量写出Skill）； 用飞书 + Skill 搭建智能记账助手，覆盖图片/文本识别、校验与写入（03_一个实战Skill用例）； 理清 Skill 包 vs API 两条主流路线与交付前检查清单（04_如何去交付Skill），并在 04_如何去交付Skill/交付Skill包指南.md 中以 OpenClaw 为例把「安装/注册 Skill 包」跑通闭环。 仓库中的 汇总可直接拷贝或打包交付的 Skill 工程，便于对照文档快速验证与二次分发。后续会持续补更多可复用的交付案例与模板。 以下仓库存储我在 YouTube 和 B 站频道关于「零基础上手 Skill 实战」相关分享的全部源文件，均开源免费。 - GitHub 地址: https://github.com/NanGePlus/SkillTutorial - Gitee 地址: https://gitee.com/NanGePlus/SkillTutorial - YouTube 频道(@南哥AGI研习社)：https://www.youtube.com/channel/UChKJGiX5ddrIpJG-rBNVZ5g - B站频道(@南哥AGI研习社)：https://space.bilibili.com/509246474 - GitHub 地址：https://github.com/NanGePlus - Gitee 地址：https://gitee.com/NanGePlus - 大模型代理平台: https://nangeai.top/ - B站视频链接：https://www.bilibili.com/video/BV1TNGZ6uEGQ/ YouTube视频链接：https://www.youtube.com/playlist?list=PL8zBXedQ0ufmOXOUX0kOZMrYt1C4fjg2T GitHub 地址：https://github.com/NanGePlus/SkillTutorial Gitee 地址：https://gitee.com/NanGePlus/SkillTutorial - B站视频链接：https://www.bilibili.

README

零基础上手 Skill：从 0 到交付的全链路闭环实战

本系列视频定位

本系列按 认知 → 编写 → 实战 → 交付闭环 串起一条可走完的路径：

认知 建立 Skill 的定位与运行机制（01_什么是Skill）；

编写 系统讲清需求澄清、description、SKILL.md 结构、渐进式披露与避坑（02_如何高质量写出Skill）；

实战 用飞书 + Skill 搭建智能记账助手，覆盖图片/文本识别、校验与写入（03_一个实战Skill用例）；

交付 理清 Skill 包 vs API 两条主流路线与交付前检查清单（04_如何去交付Skill），并在 04_如何去交付Skill/交付Skill包指南.md 中以 OpenClaw 为例把「安装/注册 Skill 包」跑通闭环。

仓库中的 05_Skills合集 汇总可直接拷贝或打包交付的 Skill 工程，便于对照文档快速验证与二次分发。后续会持续补更多可复用的交付案例与模板。

仓库目录速览

目录 说明
01_什么是Skill Skill 概念、组成与运行逻辑
02_如何高质量写出Skill 高质量编写方法论与自检
03_一个实战Skill用例 飞书记账助手：从配置到跑通全流程
04_如何去交付Skill 交付决策、检查清单；子文件 交付Skill包指南.md 为 OpenClaw 安装注册实操
05_Skill合集 成品 Skill 包

本系列仓库位置

以下仓库存储我在 YouTube 和 B 站频道关于「零基础上手 Skill 实战」相关分享的全部源文件，均开源免费。

我的个人信息

其他开源分享推荐

本系列视频链接地址速查

【整体介绍】零基础上手 Skill：从 0 到交付的全链路闭环实战。本系列按 认知 → 编写 → 实战 → 交付闭环 串起一条可走完的路径。源文件均开源免费。
YouTube频道对应视频: https://youtu.be/2FUWZ4jCc2U
B站频道对应视频: https://www.bilibili.com/video/BV1TNGZ6uEGQ/

【EP01_什么是Skill，建立对Skill的整体认知】零基础上手 Skill：从 0 到交付的全链路闭环实战。认知 → 编写 → 实战 → 交付闭环完整路径
YouTube频道对应视频: https://youtu.be/kmnOE4CY4o8
B站频道对应视频: https://www.bilibili.com/video/BV1fdVN6jEc4/
对应的文件夹：01_***

【EP02_如何把Skill写清楚写好用(附实战技巧)】零基础上手 Skill：从 0 到交付的全链路闭环实战。认知 → 编写 → 实战 → 交付闭环完整路径
YouTube频道对应视频: https://youtu.be/WzmoX4pXfUI
B站频道对应视频: https://www.bilibili.com/video/BV1sMG26qEP1/
对应的文件夹：02_***

【EP03_将一个真实业务场景落成可运行的Skill】零基础上手 Skill：从 0 到交付的全链路闭环实战。认知 → 编写 → 实战 → 交付闭环完整路径
YouTube频道对应视频: https://youtu.be/sDo8RMefMwQ
B站频道对应视频: https://www.bilibili.com/video/BV1acVs6dEdj/
对应的文件夹：03_***

【EP04_如何交付运行Skill 附实操演示（OpenClaw和WorkBuddy）】零基础上手 Skill：从 0 到交付的全链路闭环实战。认知 → 编写 → 实战 → 交付闭环完整路径
YouTube频道对应视频: https://youtu.be/Z8LMvhRXb3k
B站频道对应视频: https://www.bilibili.com/video/BV16FVY6bErQ/
对应的文件夹：04_***

适合的小伙伴

  • 希望 把重复教智能体的话术 固化成可维护、可分享资产的个人开发者或小团队。
  • 需要 在项目仓库里 与同伴共享同一套「审查清单 / 发布流程 / 领域术语表」，并让智能体在相关任务时自动或显式遵循。
  • 愿意花一点时间打磨 description 与目录结构，以换取后续对话中更稳定、更省 token 的行为。

学完后你能做什么

能力域 对应章节 能力描述
整体认知 01_什么是Skill （1）建立对 Skill 的整体理解：它不是普通文档，而是可被智能体反复加载、可版本化复用的 SOP。（2）理解 Skill 的基本组成与运行逻辑：目录 + SKILL.md、name/description 的分工、以及“渐进式披露”的加载方式。（3）分清 Skill 与单次对话提示词的边界与协作方式，知道什么时候该写 Skill、什么时候只需临时指令。（4）为后续写 Skill、做实战、谈交付打好方法论基础。
高质量写作 02_如何高质量写出Skill （1）会在动笔前做需求澄清：目的、触发场景、输出格式、领域知识、既有模式与约束。（2）能写出“找得到”的 description：第三人称、含触发词、WHAT + WHEN。（3）能把 SKILL.md 写得“读得懂、可执行”：简洁优先、篇幅控制、分层引用、按任务脆弱度设定自由度。（4）能套用模板/示例/工作流/分支/反馈闭环等写作模式，必要时配合脚本，并避开常见反面模式。（5）能按「澄清→设计→实现→验证」流程打磨，并用总结清单自检。
实战开发 03_一个实战Skill用例 （1）能把一个真实业务场景落成可运行的 Skill（飞书多维表格记账助手）。（2）掌握图片/文本两条输入链路的结构化抽取方式，并用校验门禁保证“可写入才写入”。（3）会组织 Skill 目录：主文件 + references/（提示词/字段映射）+ scripts/（写入、上传票根等），把复杂度拆开、便于维护。（4）具备把“示例跑通”迁移到其它同类场景的能力（换 prompt/字段映射/脚本即可复用）。
交付决策 04_如何去交付Skill （1）理解两条主流交付路线：交付 Skill 包（文件包） vs 交付 API 服务，知道各自的前提条件、成本结构与适用场景。（2）能根据平台能力、数据合规、定制深度、运维能力快速做选择。（3）能把交付物、运行方式、依赖、权限边界、配置与密钥、安全与稳定性、升级兼容策略写成对外可沟通的交付说明。（4）具备一套交付前检查清单，减少“交付后返工”。
交付实操（以 OpenClaw 为例） 04_如何去交付Skill （1）能把 Skill 以“Skill 包”的方式交付给支持平台，并完成安装/注册/启用。（2）知道平台侧常见的权限与沙盒限制点，能根据约束调整依赖与实现。（3）能用最小闭环验证交付是否成功：安装识别→触发运行→输出可用→异常可定位。（4）为后续把 Skill 推向更多平台或客户，建立一条可复用的交付路径。
成品 Skill 与扩展案例 05_Skill合集 直接获取仓库内维护的 Skill 工程

学习建议

  1. 顺序尽量不打乱：建议按 01 → 02 → 03 → 04 学。04 的交付决策建立在你已经跑通一个真实 Skill（03）的基础上；需要上 OpenClaw 时，再跟做 04_如何去交付Skill/交付Skill包指南.md。需要直接拿可运行包时，对照 05_Skills合集 各子目录说明操作。
  2. 先跑通再优化：先把示例按文档跑通，再回头优化 description、工作流与脚本；别一上来就追求“写得很完美”。
  3. 密钥与合规：飞书写入、上传票根、对外 API 与浏览器自动化很多是不可撤销/可审计的；重要操作先做预览与最小权限授权。不要把 API Key、token 写进 SKILL.md、references/ 或仓库里（含 .env）。
  4. 把排错沉淀成资产：每次踩坑都记录「现象 → 日志关键词/错误码 → 根因 → 修复步骤」，并回写到 references/ 或脚本的使用说明里；下次交付或迁移环境会省很多时间。
View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add nangeplus/skilltutorial
New to MCP? Start with the mcpskill.org guide →