For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
FrakmentFrakment

Skills

Portable, machine-readable instructions that teach AI agents how to work with the Frakment registry.

Frakment publishes skills that follow the Agent Skills protocol. Each skill is self-contained, versioned in the repo, and served at a stable URL so agents can load it on demand.

Why skills?

Agents that rely only on tools are blind to context. Skills fill the gap: they describe when to act, not just what to call.

Portable
Plain markdown plus YAML frontmatter. Any MCP or function-calling host can load it.
Self-describing
The description field tells the agent exactly when to load the skill.
Versioned
Skills live in the repo, versioned alongside the registry they document.

Available skills

SkillPurpose
frakment-usageDiscover, fetch, search, and install Frakment components

How agents load skills

Discover the available skills

curl https://frakment.vercel.app/.well-known/agent-skills/index.json

Fetch the skill markdown

curl https://frakment.vercel.app/.well-known/agent-skills/site-skill.md

Load into context

Feed the markdown into the system prompt or tool context. The frontmatter description is what triggered the load; the body is what the agent follows.

Where skills live

SKILL.md
SKILL.md

Anatomy of a skill

SKILL.md
name: frakment-usage
description: Load when an agent needs to discover, fetch, or install Frakment components.
allowed-tools: ["fetch", "bash"]
version: 0.1.0
PropTypeDefaultDescription
name*string—Stable slug. Must match the folder name.
description*string—One sentence telling the agent when to load this skill.
allowed-toolsstring[]—Optional hint about which tools the skill expects.
versionstring—Semver for the skill body.

Authoring a skill

Create the folder and SKILL.md

SKILL.md

Register it in frakment.json

frakment.json
{
  "skills": [
    {
      "name": "my-skill",
      "source": "skills/my-skill/SKILL.md",
      "version": "0.1.0"
    }
  ]
}

Build and publish

$ npm run registry:build

FAQ

A skill is documentation: prose that tells an agent how to act. An MCP tool is executable: a function the agent can call. Skills describe intent, MCP tools perform actions.

No. Frakment publishes skills at /.well-known/agent-skills/index.json and /skills/<name>/SKILL.md. Point your agent there.

An emerging convention for exposing SKILL.md files at predictable URLs so agents can discover and load them at runtime. Frakment follows the schemas.agentskills.io discovery schema.