# Example Command

> An example user-invoked skill that demonstrates frontmatter options and the skills/<name>/SKILL.md layout

- Skill: `nota-america/example-command` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nota-america/example-command`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nota-america/example-command/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nota-america (https://skillmd.com/u/nota-america)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nota-america/example-command

---


# Example Command (Skill Format)

This demonstrates the `skills/<name>/SKILL.md` layout for user-invoked slash commands. It is functionally identical to the legacy `commands/example-command.md` format — both are loaded the same way; only the file layout differs.

## Arguments

The user invoked this with: $ARGUMENTS

## Instructions

When this skill is invoked:

1. Parse the arguments provided by the user
2. Perform the requested action using allowed tools
3. Report results back to the user

## Frontmatter Options Reference

Skills in this layout support these frontmatter fields:

- **name**: Skill identifier (matches directory name)
- **description**: Short description shown in /help
- **argument-hint**: Hints for command arguments shown to user
- **allowed-tools**: Pre-approved tools for this skill (reduces permission prompts)
- **model**: Override the model (e.g., "haiku", "sonnet", "opus")

## Example Usage

```
/example-command my-argument
/example-command arg1 arg2
```