Summary
Skill 架构设计参考。当用户需要创建新 Skill、审查已有 Skill 的结构、或优化 SKILL.md 的 目录/引用/description 时使用。覆盖：渐进式加载、self-contained 文件拆分、description 编写、 引用策略、目录结构、常见反模式。与 skill-creator…
soulchildtc/soulchild-skills · Archived
skill-architecture-guide
Skill 架构设计参考。当用户需要创建新 Skill、审查已有 Skill 的结构、或优化 SKILL.md 的 目录/引用/description 时使用。覆盖：渐进式加载、self-contained 文件拆分、description 编写、 引用策略、目录结构、常见反模式。与 skill-creator 互补（前? Proactively suggest when user says "帮我优化这个 skill"、"帮我设计一个 skill 的结构"、 "这个 skill 的文件组织合理吗"、"怎么组织 skill 的文件"。
Installation
$
npx skills add soulchildtc/soulchild-skills --skill skill-architecture-guide
Stronger alternatives
This repository is archived — consider an actively maintained alternative.
prompt-gen
Same source · more installs
soulchildtc/soulchild-skills
生成高质量结构化提示词。当用户说"帮我写个提示词"、"优化这个 prompt"、"生成 prompt"、 "写一个 AI…
4 installs
code-explorer
Same source · more installs
soulchildtc/soulchild-skills
通用代码学习助手。帮助用户理解任意开源项目的某个功能模块：从模糊问题出发，获取代码，分析结构，…
3 installs
opencode-dev
Same source · more installs
soulchildtc/soulchild-skills
Universal Open Code development skill. Use whenever the user asks to build, modify, debug, or u…
2 installs
find-skills
Similar · more installs
vercel-labs/skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…
3.3M installsSimilar popular skills
Related neighbors and high-traction skills in the same topics — useful to compare before installing.
frontend-design
Same topic
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…
866.4K installs
agent-browser
Same topic
vercel-labs/agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…
810.4K installs
vercel-react-best-practices
Same topic
vercel-labs/agent-skills
697.8K installs
web-design-guidelines
Same topic
vercel-labs/agent-skills
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…
617.3K installs
microsoft-foundry
Same topic
microsoft/azure-skills
Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …
576.5K installs
azure-diagnostics
Same topic
microsoft/azure-skills
Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …
568.9K installsAlso in this package
Other skills from soulchildtc/soulchild-skills.
npx skills add soulchildtc/soulchild-skills
More details
Agent compatibility
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Claude Code
Not declared
Cursor
Not declared
Codex
Not declared
GitHub Copilot
Not declared
Windsurf
Not declared
Gemini CLI
Not declared
Cline
Not declared
OpenCode
Not declared
Repository health
Default branch
main
Open issues
0
Status
Archived
Skill metadata
Parsed from SKILL.md frontmatter.
Allowed tools
Read, Write, Edit, BashPackage contents
Files included with this skill beyond the listing page.
-
skill md
SKILL.md2,547 B -
docs
SUMMARY.md568 B
History
- First seen on skills.sh
- First recorded snapshot · 1 installs
SKILL.md
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
- 读
references/frontmatter-and-entry.md设计元数据和入口 - 读
references/file-structure-and-references.md规划目录结构 - 产出后用
references/quality-checklist.md自检
场景 B：用户要审查/优化现有 Skill
- 用
references/quality-checklist.md逐项扫描 - 每发现一个问题，回到对应的 reference 文件看修正方法
- 修完一项再继续下一项