Skillhub

Agent Skills for
Smart Contracts

Turn any EVM contract address into a discoverable, agent-ready SKILL.md — in seconds. AI-generated, spec-compliant, paid via x402.

How It Works View SKILL.md GitHub
The Problem

Agents can't reliably use smart contracts

AI agents need to interact with on-chain contracts but lack structured knowledge about how to do so safely and correctly.

Wasted Tokens

Agents burn context tokens parsing raw ABIs and docs with unreliable results.

Hallucinated Calls

They hallucinate function signatures, causing failed transactions and wasted gas.

Human Bottleneck

Agents ask humans for help, defeating the purpose of autonomy entirely.

How It Works

Three-stage AI pipeline

Skillhub analyzes contracts through a multi-stage pipeline with built-in validation and safety guardrails.

1

Research

LangGraph ReAct agent fetches the ABI, source code, and detects ERC patterns via Uniblock APIs. Resolves EIP-1967 proxies automatically.

2

Generate

An LLM produces a spec-compliant SKILL.md with usage patterns, gotchas, safety warnings, and code examples (<500 lines).

3

Validate

Frontmatter check, ABI cross-check, and safety scan. Retries generation on failure (max 3 attempts).

4

Store & Serve

Pinned to IPFS via Pinata. The CID becomes the permanent skill ID, accessible to any agent.

Use Cases

Who is it for?

Autonomous Agents

Mid-task, your agent encounters a contract it doesn't know. It discovers Skillhub on the Bazaar, pays $0.10 via x402, and gets a working skill — no human intervention, no API keys.

Agent Developers

Building an agent that interacts with multiple contracts? Generate skills programmatically instead of writing each one by hand. Predictable quality at $0.10/skill.

DeFi Integrations

Need your agent to swap on Uniswap, lend on Aave, or stake on Lido? Generate a skill for each protocol contract and your agent handles the rest.

Skill Marketplaces

Generated skills are open-format SKILL.md files pinned to IPFS. Portable, no lock-in. Discoverable by other agents via x402 Bazaar.

User Flow

From contract to skill

Generate
Agent
↓
POST /skills/generate$0.10 USDC
↓
PipelineResearch → Generate → Validate
↓
GET /skills/status/:sessionIdfree — poll until ready
↓
IPFS (Pinata)returns skillId (CID)
Download
Agent
↓
GET /skills/:skillId$0.01 USDC
↓
SKILL.md
↓
Skill installedskillId is the IPFS CID
API Reference

Endpoints

Method Endpoint Cost Description
POST /skills/generate $0.10 Start skill generation for a contract address
GET /skills/status/:sessionId Free Poll generation progress; returns skillId when ready
GET /skills/:skillId $0.01 Download the generated SKILL.md by IPFS CID
GET /skill.md Free Skillhub's own SKILL.md (agent instructions) 
// Generate a skill with x402 payment
const res = await fetchWithPayment('https://skills.majus.app/skills/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    contractAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
    chainId: 'eip155:8453',
  }),
});

const { sessionId, statusUrl } = await res.json();
Built With

Technology Stack

Node.js + Express x402 Payments LangChain + LangGraph LLM Uniblock APIs IPFS (Pinata) Base Mainnet x402 Bazaar
Getting Started

Install & use in seconds

Add Skillhub to your agent using the OWS CLI with ows-sign skill. Your agent pays per use via x402.

Claude — agent session
you Fetch this skill https://skills.majus.app
agent Fetching…
Make x402 payment — fetching SKILL.md
Skill ready. Generate costs $0.10 USDC, download $0.01 USDC
you Generate skill for 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base.
agent Generating…
Paying $0.10 USDC via x402
Research → Generate → Validate…
Pinning to IPFS via Pinata
Ready — skillId: bafybeig…
you Download the skill
agent Downloading…
Paying $0.01 USDC via x402
SKILL.md installed — USDC (ERC-20) on Base