Skip to content

Skills

A skill supplies instructions loaded on demand. Use skills for release procedures, review checklists and project conventions.

How a skill is written

Create <skill-directory>/SKILL.md:

---
name: check-release
description: Validate a release before publication.
---

1. Run the project's checks.
2. Verify the package version and changelog.
3. Report the artifacts ready for publication.

The agent sees the name and description before loading the body. A skill supplies instructions; it does not register an executable tool.

Where skills live

Store project skills in .gdc/skills/<name>/SKILL.md or add scan paths:

[skills]
paths = ["~/gdc-skills", "./.gdc/skills"]

See configuration.

Skills vs. memory vs. output styles

Setting Purpose
Skill Procedure loaded for a relevant task
Memory Durable notes across sessions
Output style Reply format