agentsclimarketplace

Skill architecture guide

Skill SoulChildTc/soulchild-skills/skill-architecture-guide

我的个人 AI Skills 合集

Install
npx -y skills add SoulChildTc/soulchild-skills --skill skill-architecture-guide

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Skill 架构设计参考。当用户需要创建新 Skill、审查已有 Skill 的结构、或优化 SKILL.md 的 目录/引用/description 时使用。覆盖：渐进式加载、self-contained 文件拆分、description 编写、 引用策略、目录结构、常见反模式。与 skill-creator 互补（前者管 TDD 流程，这个管结构设计）。 Proactively suggest when user says "帮我优化这个 skill"、"帮我设计一个 skill 的结构"、 "这个 skill 的文件组织合理吗"、"怎么组织 skill 的文件"。

SKILL.md

2.5 KB, 606 tokens by cl100k_base, as published. Nobody here has run it

Skill Architecture Guide

什么时候用

这个 skill 管的是 Skill 的结构设计（文件怎么放、引用怎么指、description 怎么写），不覆盖 Skill 的 TDD 创建流程。如果用户同时需要创建流程指导，推荐配合 skill-creator 使用。

核心原则速览

原则一句话
渐进式加载SKILL.md 精简，references/ 放细节，按需加载
Self-Contained每个 reference 文件只做一件事，AI 独立读取
一级引用所有引用从 SKILL.md 出发，不要嵌套
目录索引超过 100 行的引用文件必须有目录
简洁为王假设 AI 已经够聪明，不加冗余解释

快速导航

设计 SKILL.md 入口： references/frontmatter-and-entry.md

  • Description 怎么写才准（含大量正反例）
  • triggers / allowed-tools / preamble-tier 怎么配
  • 意图路由表的构建方法

拆分 references/： references/file-structure-and-references.md

  • 什么时候拆文件、什么时候合
  • 渐进式加载的 3 种组织模式
  • 长文件的目录结构规范

质量把关： references/quality-checklist.md

  • SKILL.md 检查清单
  • 引用文件检查清单
  • Description 检查清单
  • 常见反模式 + 修正方法

获取上下文

场景 A：用户要创建一个全新 Skill

  1. 读 references/frontmatter-and-entry.md 设计元数据和入口
  2. 读 references/file-structure-and-references.md 规划目录结构
  3. 产出后用 references/quality-checklist.md 自检

场景 B：用户要审查/优化现有 Skill

  1. 用 references/quality-checklist.md 逐项扫描
  2. 每发现一个问题，回到对应的 reference 文件看修正方法
  3. 修完一项再继续下一项

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.