skillstash-management

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 | …