七份指南，让你的 skill 不再默默失效。

描述永远匹配不上、YAML 解析失败、agent 用眼睛「检查」兩千行資料——14 個常見錯誤與精確修法，中英對照，外加 5 個可直接跑的 skill、腳本與 10 個通過的測試。Claude Code 與 Codex。一次 $19。

一次 US$19 · 退款政策（英文） · 价格

63 个文件
中文 + English
Node 18+，无需安装依赖
约 76 KB

Skill 编写指南包

$19 美元，一次性

一次付款，不是订阅。

拿到指南 · 一次 $19

现在下单：信用卡 / Apple Pay / 银行转账发票，任选一种 · 24 小时内交付。

一次付款，不是訂閱 · 14 天全額退款 · 立即下載 · 退款政策 · 账单显示为 XyneX

包含内容

所有事实都对照 Claude Code、Codex 和 Agent Skills 官方页面核对过，日期和链接写在 SOURCES.md 里。

guides/06_common_mistakes.md包内文件

### 1. Colon inside an unquoted value
###    未加引号的值里有冒号  [tested]

See: skill runs by /name but never
triggers by itself.
现象：手动能运行，但从不自动触发。

原因：这不是合法 YAML；解析失败时
skill 以“无字段”加载，没有 description
可匹配。

修正：加引号：
description: "Checks files: lists problems."
—— tools/lint_skills.mjs 会报出此问题。

14 个常见错误之一，每条都写明现象、原因和修正。

7: 篇中英对照指南skill 如何加载 · 写出能触发的描述 · 五个完整示例讲解 · 批量迁移一组 skill · 分享前检查清单 · 14 个常见错误 · 一页速查表。
5: 个可直接使用的示例 skillCSV 检查、译文术语检查、会议记录转任务清单、双语更新日志、发布前检查。每个都带一个小 Node 脚本、样例数据和含通过标准的测试提示词。
10: 个脚本测试，全部通过另有 skill 格式检查器（名称、描述、YAML、文件链接、长度）和测试运行器，可以直接用在你自己的 skill 上。
2: 步迁移脚本先规划、再迁移：把一组 skill 搬到其他平台，内含现成的 Codex 映射和可自行填写的通用映射。

前 10 分钟

跑一遍测试。
node tools/test_skills.mjs 显示 10 项通过。除了 Node 18 不用装别的。
复制一个示例。
把一个 skill 文件夹放进 Claude Code 或 Codex 的 skills 目录，用它自带的样例数据试一下。
检查你自己的 skill。
对你的 skills 目录运行 node tools/lint_skills.mjs，再按 14 个常见错误逐条修正。

购买前须知

适合谁。已经在用 Claude Code 或 Codex 的开发者、一人创业者和运营人员，中文或英文都可以。
写明测试范围。示例通过了 claude plugin validate（Claude Code 2.1.316）。Codex 映射对照了 Codex 文档；示例没有在真实 Codex 会话里运行过。
文件归你。付款后 24 小时内通过邮件发送纯文本文件，无需账号、无需安装。可用于自己和客户的项目，请勿转售。

XyneX 的另一款产品

一人 AI 公司模板包

brief、状态记录、人工确认节点、6 份清单和 7 个提示词，让你的智能体像小团队一样分工。每月 $9.99。

了解模板包

免費指南（不用留 email，不用註冊）

全部七篇 →

一個人怎麼用 AI 智能體開公司基於資料夾的 6 步做法。
CLAUDE.md / AGENTS.md 範本可直接複製的骨架與 5 個常見錯誤。
agent 說完成，但什麼都沒變三個條件的「完成」定義。
同時開多個 Claude Code 會話角色、衝突、交接、小 context。
怎么写 CLAUDE.md范本＋五种场景例子。
AGENTS.md 与 CLAUDE.md哪个工具读哪个档。
$9.99 模板包值得買嗎？免費入門包 vs 付費版，以及什麼情況別買。
為什麼 agent 不聽 CLAUDE.md五個修法，附前後對照。
免費 8 檔入門包（寄到信箱）不用信用卡，每兩週一封信。
GitHub 免費 8 檔入門包複製、填四個空格、開跑。
AI 智能體的七道放行關卡哪些事絕對不能讓它自己做。