Skip to content

Skills System

SKILL.md declarative skills, auto-discovered, conditionally activated.

Create a Skill

In .swust-code/skills/<name>/SKILL.md:

markdown
---
name: code-review
description: Review code changes for correctness and style
---

# Code Review Skill

## Steps
1. Run `git diff` to see changes
2. Analyze each file
3. Categorize: critical / warning / suggestion
4. Provide actionable feedback

Frontmatter Fields

FieldDescription
nameSkill name (required)
descriptionDescription (required, used for search matching)
hiddenHide from user
allowed-toolsAllowed tools list
modelSpecify model
pathsConditional activation patterns

Conditional Activation

When paths exists, the skill activates only when the user touches matching files:

yaml
paths:
  - "src/components/**/*.tsx"

Uses gitignore-style pattern matching.