如何编写你自己的Claude-Skill：从SKILL.md到Python工具的完整教程-北京尧图网络

【免费下载链接】Claude-Skills385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit. Installs on Claude Code, Cursor, Codex, Gemini, Copilot, and 6 other AI assistants.项目地址https://gitcode.com/gh_mirrors/claudesk/Claude-Skills点击查看免费下载Claude-Skills 是一个开源 AI 技能库收录了 385 个 skills、77 个 expert agents 和数百个 stdlib Python 工具支持 Claude Code、Cursor、Codex、Gemini 等 11 个 AI 助手。本教程将带你从零开始编写并校验一个符合标准的 Claude Skill先了解 Skill 的标准目录结构再用脚手架一键生成骨架接着动手编写 SKILL.md 与 Python 工具脚本最后用内置的 skill-tester 完成质量评分。全程只需用到 Python 标准库无需任何额外依赖。一、Claude Skill 的标准目录结构每个 Skill 都是一个自包含的文件夹用户拷走即可直接使用。标准布局如下skill-name/ ├── SKILL.md # 主文档必需AI 助手的入口 ├── scripts/ # Python CLI 工具推荐 │ └── tool.py ├── references/ # 深度知识库可选给 AI 的上下文 │ └── guide.md └── assets/ # 用户可复用的模板可选 └── template.md知识流动方向是references/提供领域知识 → 驱动SKILL.md中的工作流 → 通过scripts/工具执行 → 产出使用assets/模板。完整架构说明见 site/assets/images/social/reference/architecture.png 对应的文档页 docs/reference/architecture.md目录结构规范在 standards/skill-authoring-standard.md 中有逐条定义。三条硬性规则新手最容易踩坑SKILL.md控制在 500 行以内超出部分拆进references/脚本只允许 Python 标准库禁止pip install第三方包和 LLM/ML 调用禁止跨 Skill 引用文件把公共函数复制一份到自己目录里二、用 create_skill.py 一键生成骨架不要手写目录结构——项目自带脚手架脚本 scripts/create_skill.py它会创建目录并预填好符合规范的 SKILL.md 模板# 克隆仓库如需本地开发 git clone https://gitcode.com/gh_mirrors/claudesk/Claude-Skills cd Claude-Skills # 生成骨架路径必须是「域名/技能名」 python scripts/create_skill.py engineering/my-new-skill --author your-name --tags devops,tools生成的骨架包含SKILL.md和scripts/、references/、examples/三个子目录SKILL.md 中已预填 frontmatter 模板和 Quick Start、Anti-Patterns 等章节占位符。加--dry-run可以先预览而不写文件。支持的 12 个域包括engineering、marketing、project-management等完整清单见 CONTRIBUTING.md。三、SKILL.md写好 frontmatter 与触发描述SKILL.md 是整个 Skill 的心脏。AI 助手靠扫描description字段来决定是否激活你的技能因此官方标准Pattern 1要求采用做什么何时用两段式写法--- name: my-skill-name # 小写连字符必须与文件夹同名 description: 一句话说明功能。Use when 触发场景A, 触发场景B, 触发场景C. license: MIT metadata: version: 1.0.0 author: your-name category: engineering # 必须匹配顶层目录名 domain: my-subdomain updated: 2026-10-23 tags: [tools, automation] ---frontmatter 字段规则完整表格见 standards/skill-authoring-standard.md字段要求name小写连字符与目录名一致description120 字符以内含真实触发词用户会说的话license默认必须为MITmetadata.tags3–8 个小写标签用于发现检索正文至少包含四部分When to Use触发条件、Workflows分步工作流、Best Practices领域专家建议、Tool Reference每个脚本的运行方法。一个可直接模仿的完整样例是 engineering/skill-tester/assets/sample-skill/SKILL.md写法指南原文在 docs/guides/authoring.md。官方反例对比写This skill helps with architecture等于什么都没说应写成System design for production software. Activate when designing new systems, evaluating tradeoffs, planning migrations。四、Python 工具脚本编写规范scripts/下的每个脚本都是独立的 CLI 工具遵循统一骨架详见 docs/guides/authoring.md#!/usr/bin/env python3 Tool description — what it does and what it outputs. import argparse import json import sys def main() - None: parser argparse.ArgumentParser(descriptionTool description) parser.add_argument(input, helpInput file or directory) parser.add_argument(--format, choices[json, text], defaulttext) args parser.parse_args() # 分析逻辑支持 JSON 与人类可读双输出 # 成功 exit 0失败 exit 非零关键约束一览标准库 onlyargparse、json、pathlib、typing绝不依赖 pip 包双输出同时支持--format json供 CI 消费和人类可读格式150–300 行太少说明功能缺失太多说明该拆分成多个脚本必须带--help、类型标注、docstring所有异常要有可操作的错误提示禁止调用 LLM/ML 接口——保持确定性与速度参考实现可打开 engineering/skill-tester/scripts/skill_validator.py 学习真实项目中的写法。五、可选增强references 与 assetsreferences/存放深度知识库框架、检查清单、监管条文单文件上限 800 行。SKILL.md 中用相对路径链接即可如 engineering/skill-tester/SKILL.md 对 5 份 references 的引用方式。assets/用户拿来即改的交付物模板如报告模板、示例数据无行数限制。如果你的技能会生成交付物建议加一个Clarify First小节列出 2–4 个最影响输出的输入项未知时先问用户而不是擅自假设。六、用 skill-tester 校验与评分提交前务必跑一遍官方校验器 engineering/skill-tester/三个工具各司其职# 1. 校验目录结构、frontmatter、必需章节 python engineering/skill-tester/scripts/skill_validator.py path/to/your-skill --tier POWERFUL --json # 2. 语法 stdlib 导入检查实际运行 --help python engineering/skill-tester/scripts/script_tester.py path/to/your-skill --timeout 30 # 3. 四维度质量打分A 到 F并给出改进路线图 python engineering/skill-tester/scripts/quality_scorer.py path/to/your-skill --detailed --minimum-score 75校验器会检查 YAML 完整性、脚本是否纯标准库、是否支持--format json并按 BASIC / STANDARD / POWERFUL 三级给出结构阈值。七、发布前质量清单对照 standards/skill-authoring-standard.md 的最终 Checklist 自查✅name与目录名一致frontmatter 字段齐全✅ SKILL.md ≤ 500 行前 3 行就能让 AI 判断何时激活✅ 建议有立场——Use X because Y 优于 You could use X or Y✅ 至少 3 条来自真实经验的 Anti-Patterns✅ 脚本全部通过 stdlib-only 检查双格式输出✅把整个 Skill 文件夹复制到空目录确认所有相对路径可解析自包含测试✅ 能帮用户节省 40% 以上时间——达不到就重新设计完成以上步骤你的第一个 Claude Skill 就正式可用了。想进一步把它包装成专家角色可参考 templates/agent-template.md 中的 agent 模板。祝创作顺利赞分享【免费下载链接】Claude-Skills385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit. Installs on Claude Code, Cursor, Codex, Gemini, Copilot, and 6 other AI assistants.项目地址https://gitcode.com/gh_mirrors/claudesk/Claude-Skills点击查看免费下载相关推荐如何编写你自己的Agent Skill基于second-brain-os的5个SKILL.md实战技巧如何编写你自己的Agent Skill基于second brain os的5个SKILL.md实战技巧 second brain os 是一个会用 AI如何编写自己的 Agent SkillHugging Face Skills 的 SKILL.md 规范与开发实战如何编写自己的 Agent SkillHugging Face Skills 的 SKILL.md 规范与开发实战核心关键词Agent Skill、SKIAI 技能人工智能AI 评测模型评测如何编写你自己的Agent Skill从marketing-skills的170个真实示例学SKILL.md写作规范与质量清单如何编写你自己的Agent Skill从marketing skills的170个真实示例学SKILL.md写作规范与质量清单 marketing skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

如何编写你自己的Claude-Skill：从SKILL.md到Python工具的完整教程

相关推荐

从 12.6K 到 67K：一个 IBM 开源的“文档翻译官”，被中文开发者聊了一年半

如何打造口袋网络监测神器：Ragnar 硬件与显示全攻略（E-Paper、TFT、Pineapple Pager 与 Gen 2 参考机型）

Effective C++精读：语言联邦、const与初始化实战

更多资讯

JavaEE四层架构：MyBatis→Spring→AOP→Spring MVC知识地图

CUPS 2.3.3源码编译、打印队列配置与链路排障实战

Matlab图像处理实战：轮廓提取与凹多边形内角计算

激光加工金刚石的技术优势与工艺优化

C# PACS源码实战：DICOM影像归档与二次开发避坑指南

C# Winform影院售票系统：数据库设计与事务并发控制实战

今日更新

Verilog实现FPGA密码锁：矩阵键盘与状态机设计实战

数据服务监控运维实战：从指标体系到告警治理与故障排查

FreeRTOS任务通知实战详解：内核原理、API与避坑指南

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？