Skip to main content
Skills are instruction files that help AI agents do specific tasks better. They live in .claude/skills/ and get loaded when a task matches their trigger.

How Skills Work

Quick Start

Skill Levels

Writing a Skill

Create .claude/skills/my-skill/SKILL.md:

The Improvement Loop

Skills get better automatically through usage:
1

Agent uses skill

Session reads SKILL.md, follows instructions, produces output. skill-tracker.ts logs the read event.
2

Journal captures outcome

Session journal records what worked, what failed, what the human fixed.
3

Harvest learnings

tenet skills harvest <name> extracts learnings from journals. Patterns: fixes after skill use, decisions overriding defaults, discoveries.
4

Behavioral eval measures

Eval tests: does using this skill produce working output? NOT: does SKILL.md contain specific strings.
5

Build agent improves

tenet skills improve <name> runs a build agent that rewrites SKILL.md using accumulated learnings + behavioral eval as the reward function.

Behavioral Evals

Skills have evals that test outcomes, not implementation:
Current skill evals:

Publishing Skills

Share your improved skill with the community:
This clones the registry, adds your skill, and creates a PR.

See Also