Claude Code Skills：从目录结构到实际加载（开发样例）

先说结论

Skill 是一组可复用的指令和文件。先把目录放对，再用一个明确的任务验证加载结果。

YOUR_API_KEY

这段内容只用于验证代码块能够安全渲染。

验证步骤

1. 确认标题与元数据可读取。
2. 打开 Codex 接口切换样例。
3. 查看 成本工具说明。

图片同样来自本地占位资源：

MDX 表达式验证：2。

检查阅读结构

正文中的 astro.config.mjs 与 pnpm build 使用行内代码样式。先确认范围，再验证结果。

本地核对

• 检查目录能否跳转到对应章节。
  • 中文标题需要完整显示。
  • 长代码与表格应在各自区域横向滚动。
• 检查 Light / Dark 下的正文、链接与注释。

可复核的记录，需要把预期、操作和观察到的结果分开写清楚。

const verification = { title: '文章布局开发样例', scope: '仅验证阅读结构与 MDX 渲染，不代表 Claude Code 功能已经实测通过', viewport: 390 };

---

本次记录

这份样例只覆盖文章阅读结构。有关内容组件的写法，可以参考 Astro MDX 文档。