# Example > Example skill demonstrating the SKILL.md format Use when this capability is needed. - Skill: `tomevault-io/example` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/example` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/example/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/example --- # Example Skill This is an example skill that demonstrates the format for creating custom skills. ## Purpose Skills extend the agent's capabilities by providing specialized knowledge, workflows, and instructions for specific tasks or domains. ## Structure Each skill is a directory in `skills/` containing: - `SKILL.md` (required): Main documentation with frontmatter metadata - Additional files: Scripts, configs, or reference materials (optional) ## Frontmatter The SKILL.md file must start with YAML frontmatter: ```yaml --- name: skill-name description: Brief description of what the skill does --- ``` ## Usage The agent automatically loads all skills from `skills/` and includes their content in the context. You can: - Create new skills with the `create_skill` tool - List available skills with the `list_skills` tool - Read skill content with the `read_skill` tool - Delete skills with the `delete_skill` tool ## Tips - Keep skills concise and focused - Use concrete examples over lengthy explanations - Include command templates when applicable - One skill per domain --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/louisho5) — claim your Tome and manage your conversions.