---
title: "Skill oracle — Aaron Chartier"
type: lab
url: https://aaronchartier.com/lab/skill-oracle
description: "Semantic discovery across agent skills — search by meaning, ranked by trust and popularity signals."
tags: [agent skills, semantic search, webmcp, lab]
---

# Skill oracle

Semantic discovery across agent skills — search by meaning, ranked by trust and popularity signals.

The lab page renders results from a live, read-only index; there is no write
path and no account system. Everything below is a public, unauthenticated
JSON/markdown API an agent can call directly, without loading the page.

## API

Base URL: `https://oracle.dottedsun.com`

- `GET /search?q=<query>&top_k=<n>&format=md` — ranked skill matches for a
  natural-language query (`top_k` optional, default a handful of results).
- `GET /skill/{owner}/{name}?format=md` — one skill's card: scores, snippet,
  source link.
- `GET /leaderboard?metric=<installs|installs_current|popularity|trust>` —
  ranked skills by one metric.
- `GET /capabilities` — the set of capability tags in the index, with counts.
- `GET /by-capability?tag=<tag>` — skills carrying a given capability tag.
- `GET /stats` — index-wide counts (listed, delisted, official, installs).

Append `format=md` to `/search` and `/skill/{owner}/{name}` for a
token-lean markdown rendering built for agents; omit it for JSON. Every other
endpoint above is JSON only.

**Rate limit:** 120 requests/minute. A 429 response carries a
`Retry-After` header (seconds); respect it before retrying.

## WebMCP tools

Two read-only tools are registered site-wide (any page on https://aaronchartier.com, not
just this one):

- `skill_search` — natural-language query in, ranked markdown matches out.
  Takes `top_k`, an optional integer 1..10 (default 5).
- `skill_details` — one owner/name pair in, that skill's markdown card out.

## Etiquette

Results carry short snippets and a `source_url` per skill — not full skill
bodies. Follow `source_url` to read the real thing; don't try to
reconstruct a full skill from the snippet alone.

## Pages

[Home](https://aaronchartier.com/index.md) · [About](https://aaronchartier.com/about.md) · [Projects](https://aaronchartier.com/projects.md) · [Now](https://aaronchartier.com/now.md) · [Tools](https://aaronchartier.com/tools) · [Lab](https://aaronchartier.com/lab) · [Terminal](https://aaronchartier.com/terminal) · [Blog](https://aaronchartier.com/blog) · [For agents](https://aaronchartier.com/for-agents.md) · [Skill](https://aaronchartier.com/SKILL.md)

---

Canonical: https://aaronchartier.com/lab/skill-oracle · Markdown mirror of the skill oracle lab item · © 2026 Aaron Chartier