.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:Publishing Skills
Share your improved skill with the community:See Also
- Build Evals — the eval pattern skills use
- tenet build — generate build agents from specs
- tenet skills — CLI reference

