Add batch-payments skill

[plagtech]

What this adds

A new batch-payments/SKILL.md covering multi-recipient token distributions on Ethereum and L2s.

Why this belongs in ethskills

Stock LLMs get batch payments wrong. Ask any model to "send USDC to 50 addresses" and it will generate a loop of individual transfer() calls. This is the most common pattern I see LLMs produce for multi-recipient distributions, and it's the worst way to do it — 60%+ more gas, 50 separate transactions to confirm, 50 separate signatures.

Baseline test (Claude 3.5 Sonnet, no tools)

Prompt: "Write a script to distribute USDC to 100 wallet addresses on Base using viem."

Result: Generated a for loop calling writeContract with transfer() 100 times. No mention of batch contracts, no transferFrom pattern, no awareness that production batch infrastructure exists.

Classification

Item	Classification
Batch contract pattern (don't loop transfer())	🔴 LLM blind spot — generates loops every time
Gas comparison (batch vs loop)	🔴 LLM blind spot — doesn't know the savings
SafeERC20 + safeTransferFrom inside batch	🟡 Knows concept, won't apply to batch context
x402-gated batch APIs	🔴 LLM blind spot — doesn't know this pattern exists
Multi-chain gas costs for batches	🔴 LLM blind spot — stale gas data
ERC-8004 discovery for batch services	🔴 LLM blind spot — ERC-8004 not in training data

What's NOT included (already in training data)

• Basic ERC-20 transfer() / approve() mechanics (🟢)
• What USDC is, what Base is (🟢)
• Generic Solidity array iteration (🟢)

Content verified against

• Onchain gas measurements on Base (March 2026)
• OpenZeppelin SafeERC20 v5.x
• Production batch contracts deployed on Base, Ethereum, Arbitrum
• x402 SDK documentation (https://www.x402.org)

Files changed

• batch-payments/SKILL.md (new file)
• SKILL.md (TOC entry added)

Checklist

• Ran baseline test against stock LLM (no tools/skills)
• Every item classified as 🔴, 🟡, or 🟢
• 🟢 items removed
• 🟡 items compressed
• Content verified against onchain reality

[vercel]

@plagtech is attempting to deploy a commit to the BuidlGuidl Team on Vercel.

A member of the Team first needs to authorize it.