用途：定义跨平台兼容的智能体技能正式规范，使符合规范的技能可在 Claude Code（Anthropic）、Codex CLI（OpenAI）、Cursor（Anysphere）、Amp（Sourcegraph）、Letta（memGPT）及未来智能体上运行；不合规技能会静默失效或校验失败。
主要能力与规则：SKILL.md 采用 YAML frontmatter。name 必填，要求小写、连字符、1-64 字符、不含连续 --、无首尾连字符；description 必填，1-1024 字符，不得含 < 或 >，并说明何时使用；license、compatibility（最多 500 字符）、metadata（自定义键值）、allowed-tools（空格分隔，实验性）可选。
演化鲁棒性模式：渐进披露分三层——第 1 层 name+description（约 100 tokens，启动加载），第 2 层 SKILL.md 正文（<5000 tokens，激活加载），第 3 层 scripts/、references/、assets/（按需加载）；正文控制在 500 行内。跨平台兼容应写通用能力（如 compatibility: Requires MCP server access），避免平台专属项。可在 scripts/validate.sh 内嵌校验，并在 metadata 中维护语义化版本。plurigrid/asi 技能可用 trit 三元分类：-1 验证约束、0 平衡中介、+1 生成探索，组合要求 Σ trits ≡ 0 (mod 3)。
目录结构：skill-name/ 下含 SKILL.md（必需）、scripts/、references/、assets/。
校验命令：skills-ref validate ./my-skill；python3 codex-rs/core/src/skills/assets/samples/skill-creator/scripts/quick_validate.py ./my-skill；批量：for d in skills/*/; do skills-ref validate "$d"; done。
常见失败与修复：缺 YAML frontmatter 加 ---；出现意外键移至 metadata；description 含尖括号需删除；name 非连字符格式需小写连字符；description 过长上限 1024；YAML 值含冒号需加引号。
演进策略：从最小内容起步，按需加 scripts/ 与 references/，每次提交经 CI 校验。