create-skill
Skills in Val Town instruct Townie and other AI agents using the Val Town MCP server how to write idiomatic vals that respect a user's preferences and knowledge.
In any val, a user can create a /skills/<name>/SKILL.md file, e.g. /skills/design/SKILL.md.
Townie and the Val Town MCP server index skills with that directory/file structure across all of a user's vals.
A user may choose to centralize their skills in one val or co-locate skills across multiple vals.
Frontmatter
A skill markdown file must have frontmatter:
name: kebab-case name of the skill; contains lowercase letters, numbers, and hyphensdescription: helps the agent decide when the skill is relevant. A good skill description is critical for agent discoverytriggers: (optional) is a list of keywords to tip off the agent
The description and triggers fields enable skill discovery, i.e. tells the user's AI agent (e.g. Claude Code, Codex, Cursor) when to use it.
The more specific the better, including key terms that should trigger use (which can also be enumerated in triggers).
Skills without frontmatter will be silently skipped, so Townie/MCP will not be able to access them.