Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.selftune.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
What is a skill?

A skill is a SKILL.md file that defines what an AI agent can do. Each skill has:
  • Name — a unique identifier
  • Description — what the skill does and when to trigger it
  • Trigger keywords — words and phrases that should activate the skill
  • Workflow instructions — step-by-step guide for the agent to follow
When a user sends a query to an AI agent, the agent reads available SKILL.md files and routes the query to the matching skill based on the description and trigger keywords.

​
The problem with static descriptions

Skill descriptions are written by developers who think about their skill in technical terms. But users describe tasks in their own words:
Developer writesUser says
”Create PowerPoint presentations""make me a slide deck"
"Execute web security assessment""check if my site is vulnerable"
"Generate TypeScript CLI tools""build me a command-line thing”
This mismatch causes false negatives — the skill exists but doesn’t fire because the description doesn’t match how the user asked.

​
How selftune fixes this

selftune observes real user queries, detects when skills should have fired but didn’t, and evolves the descriptions to cover natural language patterns. After evolution, the pptx skill description might change from: 
- Create PowerPoint presentations from structured data
+ Create PowerPoint presentations and slide decks from structured data, outlines,
+ or natural language descriptions. USE WHEN presentation, slides, deck, pptx,
+ PowerPoint, pitch deck, board deck, keynote export.

​
Skill health states

selftune tracks each skill’s health:
StateMeaning
HealthyPass rate above threshold, no recent regressions
WarningPass rate declining or missed queries detected
CriticalPass rate below threshold or active regression
UnknownNot enough data to determine health
View skill health with: 
selftune status

​
Multi-skill management

When you have many skills, selftune helps prevent conflicts:
  • Composability analysis detects when skills overlap or interfere with each other
  • Family overlap detection identifies skills within a family that compete for the same queries
  • Workflow discovery finds multi-skill interaction patterns from real sessions
selftune eval composability --skill my-skill
selftune eval family-overlap --prefix my-family-
selftune workflows --skill my-skill