create-skill

用途

create-skill 用于把用户的偏好、技能或知识以技能文件的形式持久化到 Val Town，使 Townie 和通过 Val Town MCP 服务器连接的 AI 代理在编写 vals 时能够参考这些信息，写出更符合用户习惯的代码。

主要能力

• 在任意 val 中创建 /skills/<name>/SKILL.md 文件定义技能，例如 /skills/design/SKILL.md。
• Townie 与 Val Town MCP 服务器会按该目录与文件结构索引用户所有 val 中的技能。
• 用户可以把技能集中放在一个 val 中，也可以分散在多个 val 中共存。
• 支持通过 remix 方式复用他人技能并自定义 SKILL.md。

使用方式

技能 Markdown 文件必须包含 frontmatter：

• name：技能的 kebab-case 名称，仅含小写字母、数字和连字符。
• description：帮助代理判断技能何时相关，描述质量对代理发现技能至关重要。
• triggers（可选）：用于提示代理的关键词列表。

description 与 triggers 共同支持技能发现，让用户的 AI 代理（如 Claude Code、Codex、Cursor）知道何时使用该技能。描述越具体越好，应包含应触发使用的关键术语。没有 frontmatter 的技能会被静默跳过，Townie/MCP 无法访问。

编写建议

• 简洁，上下文窗口是公共资源。
• 始终使用第三人称。
• 默认假设 AI 代理已经足够智能。
• 尽可能具体，能写代码时优先写代码而非纯英文描述。
• 根据使用与测试持续改进技能。

示例

---

name: design description: Use when styling a val's UI. Use for frontend vals that return JSX or HTML triggers: [css, styling, layout, theme]

• Use .css files, avoid inline styles and Tailwind
• Locate React components in a /components directory, one component per file
• Use a sans-serif web-native font stack, no external fonts
• ...

重混（Remix）

可以通过 remix 其他用户的技能并定制 SKILL.md 来创建新技能。val.town 界面提供 remix 按钮，Val Town MCP 服务器提供 remix_val 工具完成该操作。

适用场景

适用于希望让 AI 代理在 Val Town 开发中遵循固定规范、偏好或领域知识的用户，尤其适合前端样式、组件组织等可复用的编码约定。

限制

技能必须包含有效 frontmatter，否则会被静默跳过。资料未提供价格、平台兼容性之外的收费或效果信息。