skill.md provides a name
Your skill.md file should declare a product name in a YAML frontmatter block so agents can identify it unambiguously.
Why a name field?
AI agents that consume skill.md files treat them as structured records, not just prose. A YAML frontmatter block at the top of the file gives the agent reliable fields it can extract without having to parse your headings.
The name field is the most important one. It is the canonical identifier the agent will use when referring to your product in conversation with a user. Without it, the agent has to guess from the first H1 or the URL, and it sometimes guesses wrong.
How to add it
Add a YAML frontmatter block at the very top of your skill.md file, before any other content. The block is delimited by three dashes on their own line.
--- name: acme-crm description: Lightweight CRM for small sales teams. --- # Acme CRM Rest of your skill.md content here...
The name should be a stable, machine-friendly identifier — typically the same slug you would use for your product on npm, GitHub, or a package registry.
Best practices
- — Use the same name everywhere: skill.md, agent.json, package.json, and your brand URL.
- — Do not change it once published. Agents may cache it.
- — Keep it lowercase and short. More on format in the next check.
- — Match it to how users actually say your product name out loud.