These are my current coding agent skills that I am experimenting with to discover the boundaries coding agents work in. Consider them early work in progress. As they mature, I'll add example uses and evaluations.
skills/
└── skill-name/
├── SKILL.md # Required - skill documentation
└── resources/ # Optional - supporting files
├── deploy/ # deployment scripts
└── ...
Each skill must have a SKILL.md file with YAML front matter:
---
name: skill-name
description: Brief description of what the skill does. Use when...
---
# Skill Title
Detailed skill documentation...name: Skill identifier (kebab-case)description: What the skill covers and when to use it
The resources/ directory stores supporting files needed by the skill:
deploy/- deployment configurations and scripts- Example files and templates
- Any non-code documentation
Note: Only include resources if the skill actually uses them.
After creating the skill, register it in two places:
Add to the top of the array:
{
"id": "skill-name",
"path": "skills/skill-name",
"category": "engineering",
"name": "skill-name",
"description": "Description of skill.",
"risk": "safe",
"source": "personal",
"date_added": "YYYY-MM-DD"
}Add to the top (after existing skills), using this format:
## skill-name
* `id`: `skill-name`
* `path`: `skills/skill-name`
* `category`: `engineering`
* `name`: `skill-name`
* `risk`: `safe`
* `source`: `personal`
* `date_added`: `YYYY-MM-DD`
### Description
Description of skill.
### Skill File
* [skills/skill-name/SKILL.md](skills/skill-name/SKILL.md)- Create directory:
skills/my-new-skill/ - Create
SKILL.mdwith front matter - Add to
skills_index.json(top of array) - Add to
skills.md(top of list)