Agent skill

Blockscout Openapi Skill

by holon-run in holon-run/uxc

Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

MITAuto-check passedBackend & APIs

Install Blockscout Openapi Skill

skills CLI
$ npx skills add holon-run/uxc --skill blockscout-openapi-skill -a claude-code

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

GitHub CLI
$ gh skill install holon-run/uxc blockscout-openapi-skill --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/holon-run/uxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/blockscout-openapi-skill .claude/skills/blockscout-openapi-skill && 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
blockscout-openapi-skill
GitHub stars
116
Token cost
~1.1k tokens
SKILL.md length
365 words
Files
5 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

  • Works in 4 steps: Use the fixed link command by default → Inspect operation schema first → Prefer narrow lookup validation before… → …
  • Tasks that involve OpenAPI specifications
  • SKILL.md covers Prerequisites, Scope, Authentication and Core Workflow, plus 4 more sections
  • Runs Shell scripts from its folder; reaches eth.blockscout.com and optimism.blockscout.com

What it does

Blockscout Openapi Skill is an agent skill from holon-run/uxc. Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/blockscout-v2.openapi.json` and `references/usage-patterns.md`).

It sits in Backend & APIs, covering OpenAPI specifications. It works with OpenAPI. The repository describes itself as: A unified CLI for discovering and invoking tools across OpenAPI, MCP, GraphQL, gRPC, and JSON-RPC. The licence is MIT.

When your agent uses it

  • Tasks that involve OpenAPI specifications

Example prompts

  • “/blockscout-openapi-skill”

Requirements

  • A Bash shell

Workflow steps

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

  1. Use the fixed link command by default
  2. Inspect operation schema first
  3. Prefer narrow lookup validation before larger history reads
  4. Execute with key/value parameters

What it can do on your machine

Read from SKILL.md and the folder at commit 562d47c. 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.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • eth.blockscout.com
    • optimism.blockscout.com

    Also links to:

    • docs.blockscout.com

    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

Blockscout Openapi Skill loads about 1.1k tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 365 words of instructions outside code blocks.

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

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 holon-run/uxc at commit 562d47c, republished under its MIT licence (© holon-run). 365 words, ~1,108 tokens.

Download SKILL.mdSave it as .claude/skills/blockscout-openapi-skill/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
blockscout-openapi-skill
description
Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

Blockscout Explorer API Skill

Use this skill to run Blockscout explorer operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to a Blockscout deployment that exposes /api/v2.
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
  • A target Blockscout instance. Examples in this skill use https://eth.blockscout.com/api/v2.

Scope

This skill covers a read-first explorer surface:

  • address summary lookup
  • address token balances
  • address transaction history
  • token metadata
  • token holder reads
  • transaction detail lookup
  • block detail lookup

This skill does not cover:

  • Blockscout GraphQL
  • raw JSON-RPC proxying
  • write operations or admin/configuration flows
  • custom authenticated gateways beyond what the caller explicitly binds

Authentication

Public Blockscout instances usually allow explorer reads without auth.

If you are targeting a self-hosted or gateway-protected instance, configure auth separately with standard uxc auth bindings for that host. This skill does not assume any default credential.

Core Workflow

  1. Use the fixed link command by default:

    • command -v blockscout-openapi-cli
    • If missing, create it: uxc link blockscout-openapi-cli https://eth.blockscout.com/api/v2 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
    • blockscout-openapi-cli -h
  2. Inspect operation schema first:

    • blockscout-openapi-cli get:/addresses/{address_hash} -h
    • blockscout-openapi-cli get:/tokens/{address_hash} -h
    • blockscout-openapi-cli get:/transactions/{hash} -h
  3. Prefer narrow lookup validation before larger history reads:

    • blockscout-openapi-cli get:/blocks/{block_number_or_hash} block_number_or_hash=latest
    • blockscout-openapi-cli get:/addresses/{address_hash} address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    • blockscout-openapi-cli get:/tokens/{address_hash} address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
  4. Execute with key/value parameters:

    • blockscout-openapi-cli get:/addresses/{address_hash}/transactions address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    • blockscout-openapi-cli get:/tokens/{address_hash}/holders address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
Show full SKILL.md (146 more words)Show less

Operation Groups

Address Reads
  • get:/addresses/{address_hash}
  • get:/addresses/{address_hash}/token-balances
  • get:/addresses/{address_hash}/transactions
Token, Transaction, And Block Reads
  • get:/tokens/{address_hash}
  • get:/tokens/{address_hash}/holders
  • get:/transactions/{hash}
  • get:/blocks/{block_number_or_hash}

Multi-Instance Use

To target a different Blockscout deployment, keep the same schema and relink the command to another host that serves /api/v2:

bash
uxc link blockscout-openapi-cli https://optimism.blockscout.com/api/v2 \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json

Guardrails

  • Keep automation on the JSON output envelope; do not use --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Treat this v1 skill as read-only. Do not imply transaction broadcast or contract write support.
  • This schema is designed for Blockscout deployments that expose the explorer REST surface at /api/v2. If host help fails, check the deployment path before assuming a protocol mismatch.
  • Pagination and filter options vary across deployments. Start with host help and operation help on the target instance before building large crawls.
  • blockscout-openapi-cli <operation> ... is equivalent to uxc <blockscout_api_v2_host> --schema-url <blockscout_openapi_schema> <operation> ....

References

© holon-run, 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 4 other files (scripts, references) in skills/blockscout-openapi-skill of holon-run/uxc.

  • SKILL.md
  • agents/openai.yaml
  • references/blockscout-v2.openapi.json
  • references/usage-patterns.md
  • scripts/validate.sh

Open the folder on GitHubat commit 562d47c

Compare with similar skills

Blockscout Openapi Skill 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.

Blockscout Openapi Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blockscout Openapi Skill this skillholon-run/uxc116—~1.1kAutomated safety check: PassMIT
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Step Partsearthtojake/text-to-cad19k1 repos~1.5kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
API DesignerJeffallan/claude-skills12k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Step Parts

    earthtojake/text-to-cad

    Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…

    19k GitHub starsUsed in 1 repo~1.5k tokens
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 1 repo~2k tokens
    Backend & APIsAuto-check passed
  • CLI Creator

    huangruiteng/CS-Notes

    Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script.

    4k GitHub starsUsed in 2 repos~2.7k tokens
    Backend & APIsAuto-check passed

More from holon-run/uxc

All 62 skills in this repo
  • Context7 MCP Skill

    holon-run/uxc

    Query up-to-date library documentation and code examples using Context7 MCP.

    116 GitHub stars~564 tokensUpdated 24 days ago
    Auto-check passed
  • Deepwiki MCP Skill

    holon-run/uxc

    Ask questions and read documentation about any GitHub repository using DeepWiki MCP.

    116 GitHub stars~700 tokensUpdated 24 days ago
    Auto-check passed
  • Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Notion Public API through UXC with a curated OpenAPI schema for search, block traversal, page reads, content writes, and data source/database inspection.

    116 GitHub stars~2.3k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

    116 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Uxc

    holon-run/uxc

    Discover and call remote schema-exposed interfaces with UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed

Works with

Categories

Questions about Blockscout Openapi Skill

What does Blockscout Openapi Skill do?

Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails. Blockscout Openapi Skill is an agent skill from holon-run/uxc. Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

When should I use Blockscout Openapi Skill?

Blockscout Openapi Skill fits situations like: tasks that involve OpenAPI specifications.

How do I install Blockscout Openapi Skill in Claude Code?

Run `npx skills add holon-run/uxc --skill blockscout-openapi-skill -a claude-code`. Or copy the skill folder (skills/blockscout-openapi-skill in holon-run/uxc) into .claude/skills/blockscout-openapi-skill in your project. Claude Code loads it when a task matches its description.

How do I install Blockscout Openapi Skill in Codex?

Run `npx skills add holon-run/uxc --skill blockscout-openapi-skill -a codex`. Or copy the skill folder (skills/blockscout-openapi-skill in holon-run/uxc) into .agents/skills/blockscout-openapi-skill in your project. Codex loads it when a task matches its description.

Can I use Blockscout Openapi Skill 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 holon-run/uxc --skill blockscout-openapi-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blockscout-openapi-skill, .gemini/skills/blockscout-openapi-skill, .github/skills/blockscout-openapi-skill and .opencode/skills/blockscout-openapi-skill in your project.

What does Blockscout Openapi Skill need to run?

Going by SKILL.md and its folder, Blockscout Openapi Skill needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Blockscout Openapi Skill access the network?

SKILL.md names 3 domains. In commands or code: eth.blockscout.com and optimism.blockscout.com; the agent is likely to contact these when it follows the instructions. As links in the text: docs.blockscout.com. This is read from the text; nothing was executed.

Is Blockscout Openapi Skill 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 Blockscout Openapi Skill use?

Blockscout Openapi Skill 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 Blockscout Openapi Skill use?

About 1.1k tokens (SKILL.md is roughly 4.4k 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 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Blockscout Openapi Skill?

Skills that share tags, products or a category with Blockscout Openapi Skill: ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars), Step Parts (earthtojake/text-to-cad, 19k stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars) and Use Yaak (mountain-loop/yaak, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blockscout Openapi Skill?

holon-run (a GitHub organization) maintains it in holon-run/uxc, which has 116 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 15, 2026.

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