尧图网站建设 
如何让你的AI Agent技能被n-skills收录完整贡献流程、审核标准与质量清单【免费下载链接】n-skillsCurated plugin marketplace for AI agents - works with Claude Code, Codex, and openskills项目地址: https://gitcode.com/gh_mirrors/ns/n-skillsn-skills是一个精选的 AI Agent 技能市场curated marketplace你的技能在这里只需编写一次即可在 Claude Code、Codex、Cursor、Copilot 等所有主流 Agent 中运行。本文用一篇指南讲清楚三件事如何提交技能、审核者看什么、提交前如何用质量清单自检。n-skills 是什么为什么值得被收录n-skills 的理念是Write once. Run everywhere.写一次到处跑。它基于开放的agentskills.io标准组成部分作用SKILL.md通用的技能定义格式AGENTS.md通用的技能发现文件已被 2 万 仓库采用openskills通用安装器被收录后用户只需一条命令即可安装你的技能/plugin install your-skilln-skills这意味着一次提交触达所有 Agent 生态的用户。提交前必读SKILL.md 的两个必填字段每个技能必须包含一个SKILL.md文件文件头YAML frontmatter有两个必填字段这是审核中最常见的打回原因字段约束常见错误name最长 64 字符仅小写字母、数字、连字符不能以连字符开头/结尾不能连续两个连字符必须与父目录名完全一致用了大写、下划线或名字和目录名对不上description最长 1024 字符要写清做什么什么时候用并包含触发关键词只写了一句 Helps with PDFs好描述的公式做什么 使用场景 触发词。例如从 PDF 文件中提取文本和表格合并多个 PDF。当用户处理 PDF 文档或提到表单、文档提取时使用。两种收录方式外部同步 vs 原生提交方式一外部技能推荐 ⭐技能留在你自己的仓库里n-skills 每天自动同步。✅ 你保留完整所有权✅ 更新自动同步每日 cron✅ 署名通过.source.json完整保留流程提一个 Issue附上你的仓库地址、技能文件夹路径、简短描述审批通过后提交 PR 在sources.yaml中增加一条条目GitHub Actions 每日自动拉取你的技能无需再管sources.yaml中的外部技能条目长这样关键字段source.repo指向你的仓库target.category决定它进入哪个分类目录- name: your-skill description: 做什么 什么时候用 触发关键词 source: repo: your-username/your-repo path: skills/your-skill ref: main target: category: tools path: skills/tools/your-skill author: name: Your Name github: your-username license: MIT homepage: 你的项目主页方式二原生技能直接把技能代码放进 n-skills 仓库Fork 仓库地址https://gitcode.com/gh_mirrors/ns/n-skills把技能加到skills/下正确的分类目录在sources.yaml中添加条目并标记native: true跑一遍下文的质量清单提 PR 每个技能的推荐目录结构skills/ └── your-category/ └── your-skill/ # 目录名必须与 name 字段一致 └── skills/ └── your-skill/ ├── SKILL.md # 必需 ├── references/ # 可选详细文档 ├── scripts/ # 可选可执行代码 └── assets/ # 可选模板、配置分类怎么选7 个官方分类技能必须放进正确的分类目录skills/{category}/选错分类会被要求修改分类放什么toolsCLI 工具和实用程序development特定语言的开发辅助productivity工作流自动化与效率工具automation浏览器、CI/CD、系统自动化data数据库、数据处理与分析documentation文档、图表、规格说明workflow多 Agent 编排、任务协调如果你的技能不属于以上任何分类先提 Issue 提议新分类需要 2-3 个属于该分类的示例技能。详见 docs/categories.md。审核流程你的 PR 会经历哪 5 关步骤内容通过标准1️⃣ Issue 筛选评估技能与市场的契合度解决真实问题有真实价值2️⃣ 合规检查校验 SKILL.md 是否符合 agentskills.io 规范字段、命名、目录全部合规3️⃣ 人工评审评估质量与实用性指令清晰、有可运行示例4️⃣ 安全审计审查脚本与依赖无硬编码密钥、无已知漏洞5️⃣ 合并写入 sources.yaml开始同步 正式上架PR 通常在1-2 天内完成评审。❌ 明确不收的东西没有实际价值的包装层技能wrapper skills已废弃、无人维护的项目低质量提交low-effort submissions审核看重的是解决真实问题、代码干净且有文档、对开发者有真实用途、处于活跃维护状态。提交前质量清单逐项打勾再提交把这份清单当作提交前的自检表SKILL.md 文件文件名精确为SKILL.md大小写敏感YAML frontmatter 有效以---开始和结束name≤ 64 字符仅小写字母/数字/连字符name与父目录名完全一致description≤ 1024 字符description同时包含做什么和什么时候用description包含触发关键词方便 Agent 发现目录结构文件夹名与name字段一致位于正确的分类目录skills/{category}/{skill-name}/sources.yaml 条目name、description与 SKILL.md 保持一致target.category与文件夹位置匹配author信息完整name、githublicense使用 SPDX 标识符MIT、Apache-2.0 等质量标准指令清晰、可执行提供了可运行的示例无硬编码密钥或 API Key脚本无安全漏洞许可证为 Apache-2.0 或 MIT 兼容一步自检用官方校验器验证提交前先用官方校验器跑一遍能自动拦截大部分格式问题# 安装 skills-ref 校验器 npm install -g agentskills/skills-ref # 校验你的技能 skills-ref validate ./path/to/your-skill⚠️ 常见踩坑提醒不要为每个技能单独创建 plugin 条目——市场使用统一的n-skills命名空间SKILL.md建议控制在500 行以内详细内容移入references/技能在 Claude Code 中显示为n-skills:skill-name常见问题Q我的技能更新后n-skills 会同步吗会。外部技能每天自动同步且基于内容哈希检测——只有文件真正变化时才会更新。Q为什么不用 git submodule官方解释submodule hell is real。内容同步方案更简单且与 openskills、Claude Code 等所有工具兼容无需特殊处理。Q提交后多久能有反馈PR 通常 1-2 天内完成评审。如果超过这个时间没有回音可以再提一个 Issue 跟进。总结写好SKILL.mdname description 是核心→ 选对分类目录 → 提 Issue 说明价值 → 提交 PR 并按清单自检 → 通过 5 关审核。按这个流程走你的 AI Agent 技能上架 n-skills 并不复杂。【免费下载链接】n-skillsCurated plugin marketplace for AI agents - works with Claude Code, Codex, and openskills项目地址: https://gitcode.com/gh_mirrors/ns/n-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何让你的AI Agent技能被n-skills收录？完整贡献流程、审核标准与质量清单
如何让你的AI Agent技能被n-skills收录完整贡献流程、审核标准与质量清单【免费下载链接】n-skillsCurated plugin marketplace for AI agents - works with Claude Code, Codex, and openskills项目地址: https://gitcode.com/gh_mirrors/ns/n-skillsn-skills是一个精选的 AI Agent 技能市场curated marketplace你的技能在这里只需编写一次即可在 Claude Code、Codex、Cursor、Copilot 等所有主流 Agent 中运行。本文用一篇指南讲清楚三件事如何提交技能、审核者看什么、提交前如何用质量清单自检。n-skills 是什么为什么值得被收录n-skills 的理念是Write once. Run everywhere.写一次到处跑。它基于开放的agentskills.io标准组成部分作用SKILL.md通用的技能定义格式AGENTS.md通用的技能发现文件已被 2 万 仓库采用openskills通用安装器被收录后用户只需一条命令即可安装你的技能/plugin install your-skilln-skills这意味着一次提交触达所有 Agent 生态的用户。提交前必读SKILL.md 的两个必填字段每个技能必须包含一个SKILL.md文件文件头YAML frontmatter有两个必填字段这是审核中最常见的打回原因字段约束常见错误name最长 64 字符仅小写字母、数字、连字符不能以连字符开头/结尾不能连续两个连字符必须与父目录名完全一致用了大写、下划线或名字和目录名对不上description最长 1024 字符要写清做什么什么时候用并包含触发关键词只写了一句 Helps with PDFs好描述的公式做什么 使用场景 触发词。例如从 PDF 文件中提取文本和表格合并多个 PDF。当用户处理 PDF 文档或提到表单、文档提取时使用。两种收录方式外部同步 vs 原生提交方式一外部技能推荐 ⭐技能留在你自己的仓库里n-skills 每天自动同步。✅ 你保留完整所有权✅ 更新自动同步每日 cron✅ 署名通过.source.json完整保留流程提一个 Issue附上你的仓库地址、技能文件夹路径、简短描述审批通过后提交 PR 在sources.yaml中增加一条条目GitHub Actions 每日自动拉取你的技能无需再管sources.yaml中的外部技能条目长这样关键字段source.repo指向你的仓库target.category决定它进入哪个分类目录- name: your-skill description: 做什么 什么时候用 触发关键词 source: repo: your-username/your-repo path: skills/your-skill ref: main target: category: tools path: skills/tools/your-skill author: name: Your Name github: your-username license: MIT homepage: 你的项目主页方式二原生技能直接把技能代码放进 n-skills 仓库Fork 仓库地址https://gitcode.com/gh_mirrors/ns/n-skills把技能加到skills/下正确的分类目录在sources.yaml中添加条目并标记native: true跑一遍下文的质量清单提 PR 每个技能的推荐目录结构skills/ └── your-category/ └── your-skill/ # 目录名必须与 name 字段一致 └── skills/ └── your-skill/ ├── SKILL.md # 必需 ├── references/ # 可选详细文档 ├── scripts/ # 可选可执行代码 └── assets/ # 可选模板、配置分类怎么选7 个官方分类技能必须放进正确的分类目录skills/{category}/选错分类会被要求修改分类放什么toolsCLI 工具和实用程序development特定语言的开发辅助productivity工作流自动化与效率工具automation浏览器、CI/CD、系统自动化data数据库、数据处理与分析documentation文档、图表、规格说明workflow多 Agent 编排、任务协调如果你的技能不属于以上任何分类先提 Issue 提议新分类需要 2-3 个属于该分类的示例技能。详见 docs/categories.md。审核流程你的 PR 会经历哪 5 关步骤内容通过标准1️⃣ Issue 筛选评估技能与市场的契合度解决真实问题有真实价值2️⃣ 合规检查校验 SKILL.md 是否符合 agentskills.io 规范字段、命名、目录全部合规3️⃣ 人工评审评估质量与实用性指令清晰、有可运行示例4️⃣ 安全审计审查脚本与依赖无硬编码密钥、无已知漏洞5️⃣ 合并写入 sources.yaml开始同步 正式上架PR 通常在1-2 天内完成评审。❌ 明确不收的东西没有实际价值的包装层技能wrapper skills已废弃、无人维护的项目低质量提交low-effort submissions审核看重的是解决真实问题、代码干净且有文档、对开发者有真实用途、处于活跃维护状态。提交前质量清单逐项打勾再提交把这份清单当作提交前的自检表SKILL.md 文件文件名精确为SKILL.md大小写敏感YAML frontmatter 有效以---开始和结束name≤ 64 字符仅小写字母/数字/连字符name与父目录名完全一致description≤ 1024 字符description同时包含做什么和什么时候用description包含触发关键词方便 Agent 发现目录结构文件夹名与name字段一致位于正确的分类目录skills/{category}/{skill-name}/sources.yaml 条目name、description与 SKILL.md 保持一致target.category与文件夹位置匹配author信息完整name、githublicense使用 SPDX 标识符MIT、Apache-2.0 等质量标准指令清晰、可执行提供了可运行的示例无硬编码密钥或 API Key脚本无安全漏洞许可证为 Apache-2.0 或 MIT 兼容一步自检用官方校验器验证提交前先用官方校验器跑一遍能自动拦截大部分格式问题# 安装 skills-ref 校验器 npm install -g agentskills/skills-ref # 校验你的技能 skills-ref validate ./path/to/your-skill⚠️ 常见踩坑提醒不要为每个技能单独创建 plugin 条目——市场使用统一的n-skills命名空间SKILL.md建议控制在500 行以内详细内容移入references/技能在 Claude Code 中显示为n-skills:skill-name常见问题Q我的技能更新后n-skills 会同步吗会。外部技能每天自动同步且基于内容哈希检测——只有文件真正变化时才会更新。Q为什么不用 git submodule官方解释submodule hell is real。内容同步方案更简单且与 openskills、Claude Code 等所有工具兼容无需特殊处理。Q提交后多久能有反馈PR 通常 1-2 天内完成评审。如果超过这个时间没有回音可以再提一个 Issue 跟进。总结写好SKILL.mdname description 是核心→ 选对分类目录 → 提 Issue 说明价值 → 提交 PR 并按清单自检 → 通过 5 关审核。按这个流程走你的 AI Agent 技能上架 n-skills 并不复杂。【免费下载链接】n-skillsCurated plugin marketplace for AI agents - works with Claude Code, Codex, and openskills项目地址: https://gitcode.com/gh_mirrors/ns/n-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考