What problem does it solve?
This skill tells users how to create, validate, and manage skills in this Skillstash instance.
Repository Structure
skillstash/
āāā skills/ # All skills live here
ā āāā my-skill/
ā āāā SKILL.md # Required - skill definition
ā āāā references/ # Optional - docs, specs
ā āāā scripts/ # Optional - executable helpers
ā āāā assets/ # Optional - templates, configs
āāā .skillstash/
ā āāā config.yml # Skillstash configuration
āāā docs/ # Skillstash documentation
āāā scripts/ # Skillstash automation
āāā .agents/ # Agent instructions
Creating a Skill
1. Create the Directory
mkdir -p skills/my-skill-name
Use kebab-case for directory names.
2. Create SKILL.md
Every skill requires a SKILL.md with YAML frontmatter:
---
name: my-skill-name
description: Brief one-line description of what this skill does
---
# My Skill Name
## When to Use This Skill
Describe trigger conditions.
## What This Skill Does
Step-by-step instructions.
## Examples
Concrete usage examples.
3. Required Frontmatter
| Field | Description |
|-------|-------------|
| name | Must match directory name exactly (kebab-case) |
| description | One-line summary for discovery |
4. Optional Frontmatter
| Field | Description |
|-------|-------------|
| version | Semver (e.g., 1.0.0) |
| author | GitHub username |
| tags | Array for categorization |
| status | experimental, stable, deprecated |
ā¦