# Skill Creator File Structure

> Sub-skill of skill-creator: File Structure (+1).

- Skill: `vamseeachanta/skill-creator-file-structure` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/skill-creator-file-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/skill-creator-file-structure/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/skill-creator-file-structure

---


# File Structure (+1)

## File Structure


```
.Codex/skills/
└── skill-name/            # kebab-case only (no underscores, spaces, capitals)
    ├── SKILL.md           # Required: exactly "SKILL.md" (case-sensitive)
    ├── scripts/           # Optional: executable code (Python, Bash, etc.)
    ├── references/        # Optional: documentation loaded as needed
    └── assets/            # Optional: templates, fonts, icons used in output
```

**Critical rules (from Anthropic guide):**
- `SKILL.md` must be named exactly `SKILL.md` — no variations (SKILL.MD, skill.md, etc.)
- NO `README.md` inside the skill folder — all docs go in SKILL.md or references/
- Folder name must be kebab-case only (no underscores, no capitals, no spaces)
- Keep SKILL.md under 5,000 words — move detailed docs to references/ and link to them
- Do NOT use "Codex" or "anthropic" in skill name (reserved)

## SKILL.md Structure


```markdown
---
name: skill-name
description: One-line description of what this skill does and when to use it.
version: 1.0.0
category: builders
last_updated: 2026-01-02
tags: [discovery-keyword, tool-name, use-case]        # optional, free-form
related_skills:                                        # optional, by skill name
  - related-skill-1
  - related-skill-2
---

# Skill Title