How do I install the Searcher Builder skill?

Run npx skillmds@latest add hairyf/searcher-builder in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Searcher Builder safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Searcher Builder?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Searcher Builder free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Searcher Builder?

hairyf (@hairyf) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Searcher Builder by hairyf — Agent Skill

Name: Searcher Builder
Rating: 4.2 (5 reviews)
Author: hairyf

File contents

Skill is based on Ethereum builder-specs (Builder API), generated at 2026-02-24.

The Builder API lets consensus-layer clients obtain blocks from external builders (proposer-builder separation). It covers validator registration, fetching execution payload headers (bids), submitting signed blinded blocks, and fork-specific types (Bellatrix through Fulu). Use this skill when implementing or integrating with builders, relays, or validator tooling that speak the Builder API.

Core References

Topic	Description	Reference
Builder API overview	Purpose, PBS context, roles, base URL, endpoint summary	core-overview
Endpoints	Validators, getHeader, blinded_blocks v1/v2, status — request/response	core-endpoints
Types and signing	ValidatorRegistration, BuilderBid, SignedBuilderBid, blinded blocks, DOMAIN_APPLICATION_BUILDER	core-types-and-signing

Features

Registration and bidding

Topic	Description	Reference
Validator registration	Eligibility, process_registration, validation rules	features-registration
getHeader and bidding	Bid eligibility, constructing BuilderBid, getHeader semantics	features-get-header-and-bidding
Submit blinded block	v1 vs v2, verification, payload reveal, builder publish	features-submit-blinded-block
Fork versions	Bellatrix/Capella/Deneb/Electra/Fulu bid and payload differences	features-fork-versions

Best Practices

Topic	Description	Reference
Encoding and headers	JSON vs SSZ, Content-Type, Accept, Eth-Consensus-Version, optional headers	best-practices-encoding-and-headers
Bid value verification	Deneb+ excluding withdrawals from bid value, relay verification	best-practices-bid-value-verification

---name: searcher-builderdescription: Ethereum Builder API (builder-specs) for proposer-builder separation — validator registration, getHeader, submit blinded block, and fork-specific payloads.---> Skill is based on Ethereum builder-specs (Builder API), generated at 2026-02-24.The Builder API lets consensus-layer clients obtain blocks from external builders (proposer-builder separation). It covers validator registration, fetching execution payload headers (bids), submitting signed blinded blocks, and fork-specific types (Bellatrix through Fulu). Use this skill when implementing or integrating with builders, relays, or validator tooling that speak the Builder API.## Core References| Topic | Description | Reference ||-------|-------------|-----------|| Builder API overview | Purpose, PBS context, roles, base URL, endpoint summary | [core-overview](references/core-overview.md) || Endpoints | Validators, getHeader, blinded_blocks v1/v2, status — request/response | [core-endpoints](references/core-endpoints.md) || Types and signing | ValidatorRegistration, BuilderBid, SignedBuilderBid, blinded blocks, DOMAIN_APPLICATION_BUILDER | [core-types-and-signing](references/core-types-and-signing.md) |## Features### Registration and bidding| Topic | Description | Reference ||-------|-------------|-----------|| Validator registration | Eligibility, process_registration, validation rules | [features-registration](references/features-registration.md) || getHeader and bidding | Bid eligibility, constructing BuilderBid, getHeader semantics | [features-get-header-and-bidding](references/features-get-header-and-bidding.md) || Submit blinded block | v1 vs v2, verification, payload reveal, builder publish | [features-submit-blinded-block](references/features-submit-blinded-block.md) || Fork versions | Bellatrix/Capella/Deneb/Electra/Fulu bid and payload differences | [features-fork-versions](references/features-fork-versions.md) |## Best Practices| Topic | Description | Reference ||-------|-------------|-----------|| Encoding and headers | JSON vs SSZ, Content-Type, Accept, Eth-Consensus-Version, optional headers | [best-practices-encoding-and-headers](references/best-practices-encoding-and-headers.md) || Bid value verification | Deneb+ excluding withdrawals from bid value, relay verification | [best-practices-bid-value-verification](references/best-practices-bid-value-verification.md) |

Frequently asked questions

Searcher Builder