Skills

Skills are packaged capabilities that teach your AI agent how to do specific things. In the WayID ecosystem, skills are published on ClawHub and installed into your agent’s project as SKILL.md files — Markdown instruction sets that guide agent behaviour.

WayID skills

ClawHub ships the following WayID skills out of the box:

Skill	Command	Description
whoareyou	/whoareyou	Display your agent’s verified WayID identity card
who	/who	Shorthand alias for /whoareyou
way	/way	Shorthand alias for /whoareyou
wayid-claim	internal	Register your agent with WayID and receive a provenance certificate

/whoareyou (and /who, /way)

When a user invokes this skill, your agent:

1. Reads its Ed25519 public key from ~/.openclaw/identity/device.json
2. Looks up its WayID certificate via GET https://way.je/api/v1/agent/{publicKey}
3. Fetches the full identity card via GET https://way.je/api/agents/{wayidDid}/card
4. Displays a formatted identity card:

🛡️ Acme Bot @acme-bot
AI assistant for Acme Corp

✅ Verified — Concordium ID
Owned by Jane Smith (@janesmith)

View Certificate → https://way.je/agent/wayid:agent:...

If the agent is not yet verified, it shows a warning instead of the verified badge.

/who and /way are convenience aliases — they behave identically to /whoareyou.

wayid-claim

This skill handles the one-time registration of your agent with WayID. It is not user-invocable — it runs as part of the claiming flow:

1. The agent owner generates a claim token at https://way.je/claim
2. The agent signs the token with its Ed25519 private key
3. The signed token is submitted to POST https://way.je/api/v1/claim
4. On success, the agent receives a WayID DID certificate (wayid:agent:{24-char-base58})

After claiming, anyone can verify the agent at https://way.je/agent/{did}.

Installing skills

Install a skill from ClawHub:

npx clawhub@latest install <skill-name>

For example, to install the WayID identity card skill:

npx clawhub@latest install whoareyou

Skills are installed as folders in your agent’s project under skills/, each containing a SKILL.md file and metadata. Installed skills are tracked in .clawhub/lock.json.

SKILL.md format

Each skill is defined by a SKILL.md file with YAML frontmatter:

---
name: whoareyou
version: 1.0.0
description: Show your verified WayID identity card when a user asks who you are
user-invocable: true
---

# /whoareyou — Verified Identity Card

When a user types `/whoareyou`, display your verified WayID identity card...

Key fields:

• name — unique identifier, used as the slash command
• version — semantic version
• description — short summary (used for discovery search)
• user-invocable — true if users can trigger it directly, false for internal skills

Discovering skills

Browse available skills on ClawHub. Skills are indexed using vector search, so you can search by describing what you need in natural language.

Skills and trust

When an agent has published skills on ClawHub, those skills are linked to the agent’s DID and become part of its WayID certificate. Consumers can inspect an agent’s skills as part of evaluating whether to trust it.

Published skills also contribute to the agent’s trust score.