Agent skill

Build On Base

by base in base/skills

Complete Base development playbook. An agent skill from base/skills.

MITAuto-check passedAI & LLM Engineering

Install Build On Base

skills CLI
$ npx skills add base/skills --skill build-on-base -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install base/skills build-on-base --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/base/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/build-on-base .claude/skills/build-on-base && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
build-on-base
GitHub stars
121
Token cost
~804 tokens
SKILL.md length
247 words
Files
12 (incl. scripts, references)
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Complete Base development playbook. An agent skill from base/skills.

  • Works in 5 steps: Classify the task using the table above → Read the relevant reference before… → Confirm the framework with the user when… → …
  • Tasks that involve Building AI agents
  • SKILL.md covers Default Stack, Safety Guardrails, Task Routing and Operating Procedure, plus 2 more sections
  • Runs Shell scripts from its folder; calls npx

What it does

Build On Base is an agent skill from base/skills. Complete Base development playbook. Covers: (1) Network — Base RPC URLs, chain IDs (8453/84532), explorer config, testnet setup, connect to Base, Base Sepolia; (2) Contracts — Foundry deployment, forge create, BaseScan verification, CDP faucet, testnet ETH, deploy contract to Base; (3) Builder Codes — ERC-8021 attribution suffix, referral fees, dataSuffix for Wagmi/Viem/Privy/ ethers.js/window.ethereum, transaction attribution, earn referral fees, append builder code; (4) Agent registration — trading bots, AI…

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including scripts and reference files (for example `references/agents/register.md`, `references/builder-codes/overview.md` and `references/builder-codes/privy.md`).

It sits in AI & LLM Engineering, covering Building AI agents, Trading and backtesting and Deployment. It works with viem and wagmi and Ethereum. The repository describes itself as: npx skills add base/skills. The licence is MIT.

When your agent uses it

  • Tasks that involve Building AI agents
  • Tasks that involve Trading and backtesting
  • Tasks that involve Deployment

Example prompts

  • “/build-on-base”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Classify the task using the table above
  2. Read the relevant reference before implementing
  3. Confirm the framework with the user when multiple options exist (e.g., Privy vs wagmi for Builder Codes)
  4. Implement with explicit chain ID, security requirements, and all required validations
  5. Deliver diffs, install commands, and any manual steps (env vars, API key setup, wallet registration)

What it can do on your machine

Read from SKILL.md and the folder at commit 4f3d8f3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.base.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Build On Base loads about 804 tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 184 tokens; SKILL.md has 247 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~184
When it runs · the whole SKILL.md, loaded when a task matches
~804
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from base/skills at commit 4f3d8f3, republished under its MIT licence (© base). 247 words, ~804 tokens.

Download SKILL.mdSave it as .claude/skills/build-on-base/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
build-on-base
description
Complete Base development playbook. Covers: (1) Network — Base RPC URLs, chain IDs (8453/84532), explorer config, testnet setup, connect to Base, Base Sepolia; (2) Contracts — Foundry deployment, forge create, BaseScan verification, CDP faucet, testnet ETH, deploy contract to Base; (3) Builder Codes — ERC-8021 attribution suffix, referral fees, dataSuffix for Wagmi/Viem/Privy/ ethers.js/window.ethereum, transaction attribution, earn referral fees, append builder code; (4) Agent registration — trading bots, AI agents, automated senders, ERC-8021 attribution wiring, base.dev API, register agent, builder code registration; (5) Node operation — run Base node, Reth setup, hardware requirements, self-hosted RPC, sync.

Base Development

Complete playbook for building on Base L2 — network setup, smart contracts, developer tool attribution, agent registration, and node operation.

Default Stack

LayerDefault
NetworkBase Mainnet (8453) / Base Sepolia testnet (84532)
ContractsFoundry (forge create + BaseScan verification)
Transactionswagmi + viem
AttributionBuilder Codes — ERC-8021 via ox/erc8021
RPC (prod)Dedicated node provider or self-hosted Reth

Safety Guardrails

  • Never commit private keys — use cast wallet import for Foundry keystores
  • Never expose RPC API keys or CDP credentials client-side — proxy through backend
  • Never send transactions without Builder Code attribution — silent data loss, no errors, no warnings
  • Validate all user-provided shell inputs before constructing forge/cast commands (no spaces, semicolons, pipes)

Task Routing

Read the reference for your task:

TaskWhen to UseReference
Network configRPC URLs, chain IDs, explorer links, testnet setupreferences/network.md
Deploy contractsFoundry deployment, BaseScan verification, faucetreferences/deploy-contracts.md
Run a Base nodeSelf-hosted RPC, Reth, hardware requirementsreferences/run-node.md
Builder CodesAdd ERC-8021 attribution to transactionsreferences/builder-codes/overview.md
Register AI agent/botRegister wallet, get builder code, wire attributionreferences/agents/register.md

Operating Procedure

  1. Classify the task using the table above
  2. Read the relevant reference before implementing
  3. Confirm the framework with the user when multiple options exist (e.g., Privy vs wagmi for Builder Codes)
  4. Implement with explicit chain ID, security requirements, and all required validations
  5. Deliver diffs, install commands, and any manual steps (env vars, API key setup, wallet registration)

For Edge Cases and Latest API Changes

Installation

bash
npx skills add base/skills --skill build-on-base

© base, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in skills/build-on-base of base/skills.

  • SKILL.md
  • references/agents/register.md
  • references/builder-codes/overview.md
  • references/builder-codes/privy.md
  • references/builder-codes/rpc.md
  • references/builder-codes/smart-wallets.md
  • references/builder-codes/viem.md
  • references/builder-codes/wagmi.md
  • references/deploy-contracts.md
  • references/network.md
  • references/run-node.md
  • scripts/register.sh

Open the folder on GitHubat commit 4f3d8f3

Compare with similar skills

Build On Base next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Build On Base compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Build On Base this skillbase/skills121—~804Automated safety check: PassMIT
FlowCraft Config AuthoringGizClaw/flowcraft416—~1.8kAutomated safety check: PassMIT
Microsoft Foundrymicrosoft/GitHub-Copilot-for-Azure2551 repos~6.7kAutomated safety check: PassMIT
Deploy AI Agentbolivian-peru/os-moda118—~1.1kAutomated safety check: PassApache-2.0
Langsmith Deploymentsoba-labs/langchain-agent-skills107—~1.7kAutomated safety check: PassMIT
Ak Inityaalalabs/agent-kernel191—~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • Writes and validates a complete FlowCraft agent deployment: deploy.yaml, runtime settings, resource sub-documents and graph JSON, checked against a structural validator.

    416 GitHub stars~1.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Microsoft Foundry

    microsoft/GitHub-Copilot-for-Azure

    Official

    Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end.

    255 GitHub starsUsed in 1 repo~6.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Deploy AI Agent

    bolivian-peru/os-moda

    Deploy and manage AI agent workloads with GPU checks, API key management, and health monitoring

    118 GitHub stars~1.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Langsmith Deployment

    soba-labs/langchain-agent-skills

    Deploy and operate production agent servers with LangSmith Deployment.

    107 GitHub stars~1.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Ak Init

    yaalalabs/agent-kernel

    Scaffold a new Agent Kernel project from scratch. An agent skill from yaalalabs/agent-kernel.

    191 GitHub stars~2.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Google Agents CLI Adk Code

    pifferologo/cloud-agents-cli

    This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management", or needs ADK (Agent…

    129 GitHub starsUsed in 1 repo~768 tokens
    AI & LLM EngineeringAuto-check passed

More from base/skills

  • Vibenet

    base/skills

    Build on vibenet — Base's devnet for native account abstraction (EIP-8130), payer gas sponsorship (ERC-8168), and Cobalt 200ms native blocks.

    121 GitHub stars~2.7k tokensUpdated 5 days ago
    Auto-check passed
  • Plugin Review

    base/skills

    Validate and review Base MCP plugin files against the Plugin Specification.

    121 GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check passed
  • Base MCP

    base/skills

    Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com).

    121 GitHub stars~3.5k tokensUpdated 5 days ago
    Auto-check passed

Questions about Build On Base

What does Build On Base do?

Complete Base development playbook. An agent skill from base/skills. Build On Base is an agent skill from base/skills. Complete Base development playbook.

When should I use Build On Base?

Build On Base fits situations like: tasks that involve Building AI agents; tasks that involve Trading and backtesting; tasks that involve Deployment.

How do I install Build On Base in Claude Code?

Run `npx skills add base/skills --skill build-on-base -a claude-code`. Or copy the skill folder (skills/build-on-base in base/skills) into .claude/skills/build-on-base in your project. Claude Code loads it when a task matches its description.

How do I install Build On Base in Codex?

Run `npx skills add base/skills --skill build-on-base -a codex`. Or copy the skill folder (skills/build-on-base in base/skills) into .agents/skills/build-on-base in your project. Codex loads it when a task matches its description.

Can I use Build On Base in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add base/skills --skill build-on-base -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-on-base, .gemini/skills/build-on-base, .github/skills/build-on-base and .opencode/skills/build-on-base in your project.

What does Build On Base need to run?

Going by SKILL.md and its folder, Build On Base needs a shell for the scripts in its folder and the command-line tools its instructions call (npx). Our summary lists: Node.js; A Bash shell.

Does Build On Base access the network?

SKILL.md names 1 domain. As links in the text: docs.base.org. This is read from the text; nothing was executed.

Is Build On Base safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Build On Base use?

Build On Base is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Build On Base use?

About 804 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.9k tokens, read only when the agent opens those files.

What are the alternatives to Build On Base?

Skills that share tags, products or a category with Build On Base: FlowCraft Config Authoring (GizClaw/flowcraft, 416 stars), Microsoft Foundry (microsoft/GitHub-Copilot-for-Azure, 255 stars), Deploy AI Agent (bolivian-peru/os-moda, 118 stars) and Langsmith Deployment (soba-labs/langchain-agent-skills, 107 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Build On Base?

base (a GitHub organization) maintains it in base/skills, which has 121 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 1, 2026.

Source: base/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.