Skill Builder

AI-Assisted Creation

The Skill Builder is a conversational AI that guides domain experts through knowledge extraction. No coding required — the AI interviews you about your expertise and produces a structured SKILL.md.

You bring the domain knowledge. The Skill Builder handles the formatting, structure, and best practices. The result is a professional-grade skill ready for publishing.

From Expertise to Skill

Creating a skill follows a simple four-step process:

Describe your domain
Tell the builder what you're an expert in. It could be anything — medical diagnosis, legal analysis, cooking, data science, or mechanical repair.
Answer guided questions
The AI asks targeted questions to extract your procedures, decision trees, rules of thumb, and edge cases. Think of it as an interview with a skilled journalist.
Review the draft
The builder produces a complete SKILL.md draft. Review the structure, check for accuracy, and flag anything that needs refinement.
Refine and finalize
Iterate with the builder until the skill captures your expertise accurately. Add examples, edge cases, and nuance until you're satisfied.

Signing Your Skill

Every published skill is cryptographically signed by its author. Signatures are tied to your ERC-8004 on-chain identity, providing:

  • Verifiable authorship — Anyone can confirm you created this skill
  • Tamper detection — Changes to the skill after signing are detectable
  • Provenance chain — The complete history of authorship is traceable

The signing flow:

Connect wallet  →  Review skill content  →  Sign  →  Signature embedded in metadata

Versioning

Skills use semantic versioning (semver) to communicate the nature of changes:

Version part Meaning Example
MAJOR Breaking changes to skill behavior 1.0.0 → 2.0.0
MINOR New capabilities added, backwards compatible 1.0.0 → 1.1.0
PATCH Fixes, improvements, typo corrections 1.0.0 → 1.0.1

Agents can choose how to track versions:

  • 1.2.3 — Exact version, pinned
  • ^1.0 — Compatible with 1.x, auto-updates
  • latest — Always use the newest version

Each version includes a changelog entry documenting what changed and why.

Publishing Workflow

Once your skill is ready, the publishing workflow takes it from local draft to globally available:

Create          Sign           Version         Publish
  │               │               │               │
  ▼               ▼               ▼               ▼
SKILL.md      Wallet +       semver +       Marketplace
 drafted      ERC-8004      changelog      listing live

After publishing, your skill is discoverable by agents worldwide. The Skill Gateway handles distribution, payment, and analytics.

Next Steps

Learn how the Skill Gateway serves your skills to agents, or explore the agentic economy that powers monetization.