creating-skills

To create Letta Code skills, you must structure your project with a canonical SKILL.md file containing required frontmatter, then organize optional scripts, references, and assets directories to support deterministic tasks and output templates.

The required frontmatter for a Letta Code skill includes mandatory name and description fields defined within the SKILL.md file, ensuring the skill exposes a clear entry point for discovery and validation.

You package and validate Letta Code skills by following a practical workflow that initializes the skill, edits the SKILL.md and bundled resources, and enforces naming conventions to ensure compatibility with validation and packaging tooling.

Yes, you can include optional scripts, references, and assets directories when building skill units to support deterministic tasks, provide reference material, and establish output templates for the skill's processing logic.

The best way to organize resources in a Letta Code skill is to separate them into dedicated scripts, references, and assets directories, ensuring a predictable resource layout that supports validation and reuse.

Letta Code skill validation fails during packaging when the SKILL.md lacks required frontmatter, violates naming conventions, or improperly organizes bundled resources, preventing compatibility with validation tooling.