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.

​
Overview

The Skills API returns performance data for all skills tracked in your SelfTune workspace, including trigger rates, confidence metrics, and grading health.

​
List skills

GET /v1/skills
Returns a paginated list of skills with health status and performance metrics.

​
Query parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
per_pageintegerResults per page (default: 20)

​
Response

{
  "skills": [
    {
      "skill_id": "my-skill",
      "status": "healthy",
      "unique_sessions": 42,
      "has_evidence": true,
      "trigger_rate": 0.73,
      "avg_confidence": 0.88,
      "confidence_coverage": 0.95
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 5
  }
}

​
Skill fields

FieldTypeDescription
skill_idstringUnique skill identifier
statusstringhealthy, warning, critical, or unknown
unique_sessionsintegerNumber of distinct sessions where the skill was seen
has_evidencebooleanWhether graded evidence exists for this skill
trigger_ratenumber | nullFraction of sessions where the skill fired. null if not enough data.
avg_confidencenumber | nullAverage routing confidence (0–1) across all triggers. null if no confidence data.
confidence_coveragenumber | nullFraction of triggers that include a confidence score. null if not applicable.

​
Get skill detail

GET /v1/skills/:skill_id
Returns detailed performance data for a single skill.

​
Response

{
  "skill": {
    "skill_id": "my-skill",
    "status": "healthy",
    "first_seen_at": "2026-01-01T00:00:00Z",
    "last_seen_at": "2026-04-10T12:00:00Z",
    "unique_sessions": 42,
    "trigger_rate": 0.73,
    "avg_confidence": 0.88,
    "confidence_coverage": 0.95
  },
  "daily_stats": [...]
}
The skill object includes the same trigger_rate, avg_confidence, and confidence_coverage fields as the list endpoint.

​
Confidence metrics

Three fields describe how confidently and consistently the skill is being routed: trigger_rate — the fraction of recent sessions where the skill fired at least once. A low trigger rate on an active skill may indicate a routing problem or an overly narrow description. avg_confidence — the mean confidence score assigned by the routing system when it selected this skill. Higher values mean the skill’s trigger description is unambiguous. Values below ~0.6 suggest the skill may be competing with others or have an unclear scope. confidence_coverage — the fraction of triggers that included a confidence score. Some platforms do not emit confidence data; this field tells you how much of your avg_confidence value is based on actual measurements versus inferred. All three fields are null when there is not enough data to compute a meaningful value (for example, a newly added skill with no recorded sessions).

​
Authentication

All Skills API requests require a Bearer token: 
curl https://api.selftune.dev/v1/skills \
  -H "Authorization: Bearer <your-api-key>"
See Authentication for how to obtain an API key.