SkillForge

On-chain registry and paid execution layer for reusable AI agent skills on X Layer.

Every agent ecosystem rebuilds the same execution primitives — balance checks, price feeds, swap routing, token risk screening. SkillForge makes those primitives permanent, discoverable, and callable by any agent, with payment gating built into the HTTP layer.

Live


App	https://skillforge-vinaystwts-projects.vercel.app
Agent discovery endpoint	https://skillforge-vinaystwts-projects.vercel.app/api/agent
Marketplace API	https://skillforge-vinaystwts-projects.vercel.app/api/marketplace
Registry contract	0x1850d2a31... on OKLink

What It Is

SkillForge is three things working together:

An on-chain registry — SkillRegistry.sol deployed on X Layer mainnet. Creators register callable skills with name, slug, category, price, and creator provenance. Each registration is a permanent on-chain transaction.
A paid invocation gateway — HTTP endpoints for every registered skill. Calling an endpoint without a payment header returns HTTP 402 with an x402-compatible challenge. Resubmitting with the payment header returns the result and a receipt ID.
Real execution backed by OKX — skills call live OKX Onchain OS APIs: DEX price quotes, wallet balance reads, token risk screening, and swap routing. The safe-swap-execute skill composes risk scan + route quote + guarded execution in a single call.

System Architecture

flowchart LR
    Creator([Creator]) -->|registerSkill tx| REG

    subgraph Chain["X Layer Mainnet"]
        REG[(SkillRegistry.sol)]
    end

    subgraph SF["SkillForge API"]
        DISC[Discovery endpoint]
        MKT[Marketplace]
        INV[Invoke gateway]
        CHAL[x402 middleware]
    end

    subgraph OKX["OKX Onchain OS"]
        DEX[DEX Quotes]
        BAL[Wallet Balances]
        RISK[Token Risk]
    end

    REG --> MKT
    Client([Agent / Client]) -->|GET api/agent| DISC
    Client -->|POST api/skills/invoke| INV
    INV --> CHAL
    CHAL -->|HTTP 402| Client
    Client -->|replay + payment proof| INV
    INV --> DEX & BAL & RISK
    INV -->|result + receiptId| Client

x402 Payment Flow

Skills use an x402-compatible challenge-response flow. No API key needed — payment proof is passed in the HTTP header.

sequenceDiagram
    participant A as Agent / Client
    participant G as SkillForge Gateway
    participant O as OKX APIs

    A->>G: POST /api/skills/market-price-snapshot/invoke
    G-->>A: HTTP 402 + PAYMENT-REQUIRED: base64-challenge

    Note over A: Construct payment proof<br/>from challenge payload

    A->>G: POST /api/skills/market-price-snapshot/invoke<br/>+ payment-signature: base64-proof
    G->>O: fetch live market data
    O-->>G: price data
    G-->>A: HTTP 200 + result + receiptId

Skill Catalog

Slug	Category	Price	Backing
`market-price-snapshot`	Market	$0.10	OKX DEX quote API
`wallet-balance-check`	Wallet	$0.08	OKX wallet balance API
`contract-risk-scan`	Security	$0.12	OKX token risk API
`swap-route-quote`	Execution	$0.18	OKX DEX routing API
`safe-swap-execute`	Execution	$0.25	Composed: risk + quote + guarded swap
`token-holder-analysis`	Security	$0.10	Beta — holder distribution
`gas-price-snapshot`	Market	$0.06	Beta — X Layer gas estimate
`liquidity-depth-check`	Execution	$0.12	Beta — pool depth lookup

The first five skills are live and registered on-chain. Beta skills are in the catalog with mock execution.

Agent Quick-Start

Any agent can self-discover all available skills, their endpoints, prices, and the full x402 flow in one request.

1 — Discover skills

curl https://skillforge-vinaystwts-projects.vercel.app/api/agent

Response includes:

full skills manifest with slugs, endpoints, categories, prices
MCP tool definitions with JSON Schema for each skill
x402 flow instructions
cURL quickstart per skill

Response headers: X-MCP-Compatible: true, X-Registry: 0x1850d2a31..., X-Chain: eip155:196

2 — Invoke a skill (x402 flow)

Step 1 — initial request returns HTTP 402 with payment challenge:

curl -X POST https://skillforge-vinaystwts-projects.vercel.app/api/skills/market-price-snapshot/invoke \
  -H "Content-Type: application/json" \
  -d '{"amount": "0.01"}'
# → HTTP 402
# → X-Payment-Required: <base64-encoded challenge>

Step 2 — resubmit with payment header:

curl -X POST https://skillforge-vinaystwts-projects.vercel.app/api/skills/market-price-snapshot/invoke \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment-header>" \
  -d '{"amount": "0.01"}'
# → HTTP 200
# → { ok: true, result: { price, volume, ... }, receiptId: "rcpt_..." }

3 — Wallet balance check

curl -X POST https://skillforge-vinaystwts-projects.vercel.app/api/skills/wallet-balance-check/invoke \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment-header>" \
  -d '{"walletAddress": "0x89740dfdc33b07242d1276ad453e00eb56c25884"}'

4 — Safe swap (composed skill)

curl -X POST https://skillforge-vinaystwts-projects.vercel.app/api/skills/safe-swap-execute/invoke \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment-header>" \
  -d '{"fromToken": "OKB", "toToken": "USDT", "amount": "0.1"}'
# → returns: transactionHash, riskScan result, routeQuote, previousExecution proof

Onchain Verification

All activity is verifiable on OKLink X Layer explorer.

Registry contract

0x1850d2a31CB8669Ba757159B638DE19Af532ba5e — verified source code on OKLink. Ownable, Solidity ^0.8.24.

Agentic Wallet

0x89740dfdc33b07242d1276ad453e00eb56c25884 — holds USDT and OKB on X Layer mainnet. Used for demo identity and execution proof.

Mainnet swap proof

The Agentic Wallet executed a real OKB → USDT swap via SkillForge:

0x0d6da5ea1cc77c0e6943d730d7392e9a99d04ac599ab8d850214f94b4837c2ba — 0.118 OKB → 10.10 USDT

Skill registration transactions

Each of the five live skills was registered on-chain by the deployer wallet 0x94c188F8280cA706949CC030F69e42B5544514ac:

Skill	Registration tx
`market-price-snapshot`	0xaf929...
`wallet-balance-check`	0x6b431...
`contract-risk-scan`	0x6f839...
`swap-route-quote`	0x04496...
`safe-swap-execute`	0xc41c2...

Frontend

Five pages, all production-grade:

Page	Path	Description
Marketplace	`/`	Skill grid with category filters, live activity feed, composability diagram
Skill detail	`/skill/[slug]`	Per-skill invoke panel, onchain provenance, cURL example
Demo	`/demo`	Full composability demonstration with AutoDemo cascade
Publish	`/publish`	Calldata generator — produces ABI-encoded `registerSkill()` call
Dashboard	`/dashboard`	Creator view with registration tx provenance per skill

Design: dark mineral palette, Outfit + JetBrains Mono type stack, asymmetrical layout, animated reveal and composability diagram.

Monorepo Structure

apps/
  web/              Next.js 15 — marketplace frontend + serverless API routes
  api/              Express gateway (local development, CLI-backed skills)
packages/
  contracts/        Hardhat — SkillRegistry.sol, deploy scripts, seed scripts
  shared/           shared TypeScript types, skill catalog, fallback data

Local Development

Prerequisites

Node.js 20+
pnpm 9+
OKX API credentials (for live skill execution)

Setup

# clone
git clone https://github.com/Vinaystwt/skillforge
cd skillforge

# install
pnpm install

Environment

Create apps/web/.env.local:

# Network
X_LAYER_RPC=https://rpc.xlayer.tech
X_LAYER_CHAIN_ID=196

# OKX API (required for live skill invocation)
OKX_API_KEY=your_api_key
OKX_SECRET_KEY=your_secret_key
OKX_PASSPHRASE=your_passphrase

# Contract
NEXT_PUBLIC_REGISTRY_ADDRESS=0x1850d2a31CB8669Ba757159B638DE19Af532ba5e

# x402 payment configuration
X402_PAY_TO=0x89740dfdc33b07242d1276ad453e00eb56c25884
X402_NETWORK=eip155:196
X402_ASSET=0x779ded0c9e1022225f8e0630b35a9b54be713736
X402_AMOUNT_USDT=100000

# Local API (optional — for separate Express gateway)
NEXT_PUBLIC_API_BASE_URL=http://localhost:3001
API_PORT=3001
APP_URL=http://localhost:3000

Run

# frontend only (recommended for most development)
pnpm dev:web
# → http://localhost:3000

# API gateway (optional — for Express-backed skills)
pnpm dev:api
# → http://localhost:3001

# both
pnpm dev:web &
pnpm dev:api

Build

pnpm build
# runs across all packages in the workspace

Contract Operations

# compile
pnpm --filter @skillforge/contracts build

# test
pnpm --filter @skillforge/contracts test

# deploy to X Layer mainnet
pnpm --filter @skillforge/contracts exec hardhat run scripts/deploy.ts --network xlayer

# seed 5 skills into the deployed registry
pnpm --filter @skillforge/contracts exec hardhat run scripts/seed.ts --network xlayer

Requires PRIVATE_KEY and X_LAYER_RPC set in the root .env.

API Reference

All endpoints are available at the same origin as the frontend in the live deployment.

Discovery

GET /api/agent

Returns full skills manifest. Headers: X-MCP-Compatible: true, X-Registry, X-Chain.

Marketplace

GET /api/marketplace
GET /api/marketplace/skills
GET /api/marketplace/skills/:slug

Invocation

POST /api/skills/:slug/invoke

Without X-Payment header: returns HTTP 402 + X-Payment-Required challenge.
With X-Payment header: returns skill result + receiptId.

Deployment

The app is deployed on Vercel. Environment variables required in Vercel project settings:

OKX_API_KEY
OKX_SECRET_KEY
OKX_PASSPHRASE
NEXT_PUBLIC_REGISTRY_ADDRESS
X402_PAY_TO
X402_NETWORK
X402_ASSET
X402_AMOUNT_USDT
X_LAYER_RPC

Constraints and Notes

The x402 payment challenge is a standards-compatible implementation for the invocation surface. Production settlement reconciliation and replay protection can be extended for production deployments.
safe-swap-execute in the public deployment returns the real prior mainnet swap transaction as proof, alongside live risk scan and route quote data. Wallet-signed execution is an operator-controlled path.
The apps/api Express gateway is included for local development and CLI-backed skill paths. In the live Vercel deployment all skill invocations run as Next.js serverless functions.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
apps		apps
packages		packages
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
package.json		package.json
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.base.json		tsconfig.base.json

Folders and files

Latest commit

History

Repository files navigation

SkillForge

Live

What It Is

System Architecture

x402 Payment Flow

Skill Catalog

Agent Quick-Start

1 — Discover skills

2 — Invoke a skill (x402 flow)

3 — Wallet balance check

4 — Safe swap (composed skill)

Onchain Verification

Registry contract

Agentic Wallet

Mainnet swap proof

Skill registration transactions

Frontend

Monorepo Structure

Local Development

Prerequisites

Setup

Environment

Run

Build

Contract Operations

API Reference

Discovery

Marketplace

Invocation

Deployment

Constraints and Notes

License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages