Skill Wiki v0.1.0

Docs / background / existence-not-content

On this page

Existence ≠ content

Knowing that an atom for "OWASP input-validation rules" exists is different from holding all 1,841 bytes of its prose in working memory.

Wikipedia separates the two. Every reader of the encyclopedia knows there is an article on prime numbers — but they don't have its 4,000 words in their head until they navigate to it. The Wikipedia index is small; the articles are large; readers pull the article on demand.

Pre-Skill-Wiki agent stacks routinely conflate the two. Every skill that might be relevant ships its full prose into the prompt every turn, "just in case." This is the design pivot Skill Wiki rejects.

How Skill Wiki separates them

The protocol distinguishes two surfaces that an agent interacts with:

Surface Cost Always in context? Contains
Index (_index.xml) ~3 KB regardless of corpus size Yes id, kind, one-line summary, edges out
Atom body (chunks/*.md) ~30 / ~150 / ~380 tok per atom No — loaded by id, on demand full description, parameters, examples

The index is the agent's map; atom bodies are the territory.

What this enables

Bounded cost

Token cost grows with what the agent actually decides to load, not with corpus size. A 1,000-atom corpus costs the same to "have available" as a 50-atom one. The marginal atom is free until used.

Bounded pollution

Bad atoms in the corpus don't poison every turn. They sit in the index, get filtered out by retrieval per-turn, and never enter context unless retrieved. A bad SKILL.md, by contrast, pollutes every turn it's loaded for.

Push → pull inversion

The traditional pattern is push: the system pushes everything the brief might need into context, hoping the model picks the right parts. Skill Wiki is pull: the index says "an atom for GDPR right-to-erasure rules exists"; the agent decides whether to read its summary, core, or full projection.

Why "exact" is exact

The Wikipedia analogy isn't approximate; it's structural. Wikipedia's Special:AllPages is a 7 MB index. Loading it doesn't mean loading the encyclopedia. The MediaWiki runtime gives readers stable URLs, and articles materialise when the URL is requested. Replace "URL" with "atom id," "browser" with "agent," "MediaWiki" with "MCP server" and you have Skill Wiki.