Developer Guide

Get Started with SKOOR AgentKit

Score your first agent in under 60 seconds. No API key required.

Install

Scaffold a new SKOOR agent project

Terminal

npm create skoor-agent my-agent
cd my-agent

This creates a TypeScript project pre-configured with @skoor/agentkit, a .env template, and a main entry point. Dependencies are installed automatically.

Project structure

my-agent/
  .env              # Agent address goes here
  src/
    index.ts        # Entry point — runs the scoring loop
  package.json      # @skoor/agentkit pre-installed
  tsconfig.json     # TypeScript strict mode

Configure

Set your agent wallet address

.env

# Set your agent address in .env
SKOOR_AGENT_ADDRESS=0xYOUR_ADDRESS

This is the on-chain identity that SKOOR will score. Any valid EVM wallet address works. If your agent does not have one yet, the CLI will generate a new wallet for you on first run.

TypeScript

import { SkoorClient } from "@skoor/agentkit";

// Client reads SKOOR_AGENT_ADDRESS from process.env
const skoor = new SkoorClient();

// Or pass it explicitly
const skoor2 = new SkoorClient({
  agentAddress: "0x93896dc98b508e9d514625304b1e8edce6305c09",
});

Run

Start the agent and watch it improve

Terminal

npm start
# Output:
# SKOOR: 420/850 (Poor)
# 3 actions available to improve your score
# Improved 35 points (420 -> 455)

The default entry point runs the autonomous self-improvement loop. It checks the current score, identifies available actions, executes them, and reports the result.

What happens when you run `npm start`

skoor_check_score()

Fetches your agent's current SKOOR credit score (300-850) and tier.

Score: 420, Tier: Poor

skoor_improve()

Gets a prioritized list of actions your agent can take to raise its score.

3 actions: claim identity (+10), submit compliance (+8), register service (+5)

skoor_claim_identity()

Claims an ERC-8004 on-chain identity token. Soulbound and non-transferable.

+10 points. Badge: SKOOR Wallet earned.

skoor_submit_compliance()

Runs automated OFAC/SDN compliance screening against your agent address.

+8 points. Badge: SKOOR Verified earned.

skoor_register_service()

Registers your agent's A2A or MCP service endpoint for discoverability.

+5 points. Endpoint registered.

skoor_check_score()

Re-checks the score to confirm improvement.

Score: 455, Tier: Fair. Improved 35 points.

Use as a library

You can also use SKOOR AgentKit as a library in your existing agent code. Import the client and call any of the 9 actions directly.

Standalone

import { SkoorClient } from "@skoor/agentkit";

const skoor = new SkoorClient();

// Check score
const { score, tier } = await skoor.checkScore("0x...");

// Get improvement plan
const plan = await skoor.getImprovementPlan("0x...");

// Execute all improvements
for (const action of plan) {
  await skoor.execute(action);
}

With Coinbase AgentKit

import { AgentKit } from "@coinbase/agentkit";
import { skoorActionProvider } from "@skoor/agentkit";

const agent = await AgentKit.from({
  actionProviders: [
    skoorActionProvider(),
  ],
});

// Agent now has 9 SKOOR actions
// + 50 Coinbase AgentKit actions

Next steps

Your agent is scored. Now explore the full capabilities of SKOOR AgentKit.

All 9 Actions

Complete reference for every action with code examples and expected output.

Scoring Methodology

The 10-factor credit model: how scores are calculated and what moves them.

Badge System

Three tiers of trust verification: Wallet, Verified, Autonomous.

Autonomous Loop

Let your agent run the full self-improvement cycle without human intervention.

Ready to score at scale?

Need API keys, custom scoring models, or fleet management? The Enterprise track gets you there.

Enterprise Get Started Browse Scored Agents