用途：这是一份关于如何编写高效 Agent Skills（智能体技能）的指南，目标是让技能在 Claude 有限的上下文窗口中高效使用。核心观点是每个不必要的 token 都会浪费上下文、拖慢处理、增加成本，因此结构、命名与内容都应围绕这一目标展开。
主要能力与原则：一是渐进式披露，只加载所需内容，建议 SKILL.md 作为导航中枢（约 500 行以内），详细内容放入引用文件，并从 SKILL.md 直接链接，避免嵌套引用导致部分读取；文件更多优于上下文更大。二是尊重智能，假定 Claude 已懂常识，跳过文件格式、包管理器等基础概念的教程式解释，直接提供代码与命令。三是便于发现，描述需用第三人称写明能力（WHAT）与触发场景（WHEN），包含具体文件类型、技术名与活动短语。
用法要点：名称用小写字母、数字、连字符，最长 64 字符，避免 XML 标签及 anthropic、claude 等保留词；描述最长 1024 字符。路径统一用正斜杠，引用保持一级深度，超过 100 行的引用文件需加目录。常见模式包括模板、工作流、反馈循环与条件分支。自由度按任务脆弱程度选择：高自由度给指令，中自由度给模板，低自由度给脚本。
测试与存储：可用 Task 工具让子代理做发现、执行与边界测试，验证描述能否正确触发、内容是否可执行、是否会误触发。存储位置可为项目的 .agents/skills/ 或个人 ~/.agents/skills/，也可依 Cursor、Codex/Claude 等工具的目录约定；避免使用 ~/.cursor/skills-cursor/。
限制：文档所列的字符数、行数等为技术约束，具体平台与效果暂未提供。