用途：在项目的 .agents/skills 目录下创建与维护项目本地技能，覆盖新建、更新、评估与格式校验。格式与发现机制以 Vercel skills CLI 为准，除非用户明确要求，不另建本地校验器。技能应承载可复用的项目经验，如真实约定、反复出现的失败模式、脆弱流程和容易被忽略的纠正，不应把一次性建议写成技能。
目录结构：每个技能是扁平目录，必需 SKILL.md，可选 references/、scripts/、assets/。项目本地可移植技能放在 .agents/skills。必需 frontmatter 为 name 与 description，名称为小写连字符。可选字段可有意使用，如 argument-hint（需用户输入的斜杠调用技能）、disable-model-invocation（仅显式调用）、license、metadata；避免 allowed-tools、hooks、context: fork 等特定代理的执行控制字段，除非目标代理明确支持。不要按标准加入 agents/openai.yaml、scripts/init_skill.py、references/openai_yaml.md 等脚手架或装饰性资源。
创建流程：默认创建项目本地技能，先进入目标目录，再用命令 bun x --package skills skills init <skill-name> 初始化，然后直接编辑 SKILL.md。动笔前先分类技能类型（流程、工具工作流、约定或领域模式），收集真实素材（已完成任务、diff、评审意见、issue、运行手册、执行轨迹、反复纠正），确认任务、目标用户、触发用例、配套引用以及是否需要脚本。先写 description：说明做什么、具体触发情境、用户可能提到的文件类型、包、工具或短语，使用 Use when 句式，描述用户意图而非实现机制，控制在 1024 字符内。对微妙路由，用 2 到 3 个应触发提示和 1 到 2 个近似不应触发提示做测试。
渐进披露：SKILL.md 只放核心规则、常见陷阱、决策点、命令和链接，尽量少于 100 行，外边界为 Vercel 指南的 500 行；长示例、条件陷阱、评估说明、决策表、API 细节和边界情况放入 references/，每条引用链接要有具体加载条件。仅对重复、确定、脆弱或易错的工作使用 scripts/，脚本需在 SKILL.md 中说明、非交互、可重试、前置条件清楚、stdout 结构化、stderr 输出诊断且输出有界。本仓库默认用 Bun，上游 npx skills ... 示例改写为 bun x --package skills skills ...，其他 npm 命令保留包名并用 bun x 或 bunx，必要时固定版本。控制强度随脆弱度校准，批量、破坏性、外部状态或高影响操作采用计划-校验-执行。
评估与校验：新建技能、改触发描述或调微妙行为时做轻量评估，对比无技能或旧版本，在干净上下文中记录失败、浪费步骤与遗漏约定，先改描述或核心工作流。用 CLI 验证发现性，命令为 bun x --package skills skills add /Users/braden/Code/epicenter/.agents/skills --list；单个技能加 --skill <skill-name> --list，有效信号为 Local path validated 和 Found N skill(s)。不要直接传技能子目录做校验，可能报 No skills found；metadata.internal: true 的技能需传 --skill <name> 确认出现在列表中。
限制：资料未提供具体价格、平台覆盖范围、性能数据等信息，暂未提供。