# New Agent Skill

> Creates a new agent skill. Use when agent or user needs to create a new skill for the agent.

- Skill: `mystilleef/new-agent-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add mystilleef/new-agent-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mystilleef/new-agent-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: mystilleef (https://skillmd.com/u/mystilleef)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/mystilleef/new-agent-skill

---


# New agent skill

**`GOAL`**: create a new skill directory, standard sub-folders, and a
compliant `SKILL.md` template based on the local reference guide.

**`WHEN`**: you need to create a new skill for the agent.

## Prerequisites

- The `skills/` directory must exist.
- The requested skill name requires kebab-case (lowercase, alphanumeric,
  dashes).
- `references/skill-reference-guide.md` must exist.

## Efficiency directives

- Create all directories and files in a single pass.
- Optimize all operations for agent, token, and context efficiency.

## Workflow

### Step 1: Check input

- Verify the skill name follows kebab-case conventions.
- Check if `skills/<name>` already exists.
- If exists: emit `ERROR: Skill <name> already exists`.

### Step 2: Create directory structure

- Create `skills/<name>/`.
- Create `skills/<name>/SKILL.md`.
- Create standard subdirectories: `scripts/`, `references/`, `assets/`,
  `tests/`.

### Step 3: Generate `SKILL.md`

- Refine, streamline and optimize the user's instructions for the new
  skill.
- Read `references/skill-reference-guide.md`.
- Update `SKILL.md` using the reference and user's instructions. Output.

### Step 4: Report completion

- Output `SUCCESS: Created skill <name> at skills/<name>/`.

## References

- `references/skill-reference-guide.md`: The authoritative guide for
  skill structure and templating.