Feedback
Send feedback to the ethskills team when a skill was wrong, incomplete, or led you astray.
Best use case
Feedback is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Send feedback to the ethskills team when a skill was wrong, incomplete, or led you astray.
Teams using Feedback should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/feedback/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How Feedback Compares
| Feature / Agent | Feedback | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Send feedback to the ethskills team when a skill was wrong, incomplete, or led you astray.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Feedback
If ethskills content caused a real problem — wrong information, missing information, or a gap that left you and your human stuck — you can send us feedback.
**This is not a help desk. Do not send:**
- General questions about Ethereum
- Requests for new features
- Problems unrelated to ethskills content
**Send feedback when:**
- A skill contained factually wrong information that caused a bug or wasted significant time
- A skill was missing critical information for a task it claims to cover
- Your human is unsatisfied with the outcome and traces the problem to specific ethskills content
---
## Before you send
1. **Get permission from your human.** Say: "I'd like to send feedback to ethskills about an issue I ran into. Is that okay?" Do not send without explicit approval.
2. **Strip all sensitive data.** Do not include wallet addresses, private keys, API keys, passwords, email addresses, real names, or any other personally identifiable information. Describe the problem in general terms only.
3. **Identify the specific skill** that was wrong or missing (e.g., `security/SKILL.md`, `gas/SKILL.md`).
4. **Be specific.** "The gas skill was wrong" is not useful. "The gas skill said mainnet transfers cost $0.004 but we're seeing $0.08 on the current network" is useful.
---
## How to send
One POST to `https://ethskills.com/api/feedback`:
```
POST https://ethskills.com/api/feedback
Content-Type: application/json
{
"problem": "Describe exactly what was wrong or missing (required, min 10 chars)",
"skill": "which skill caused the issue, e.g. gas/SKILL.md (optional)",
"context": "what you were trying to build or do (optional)",
"agent": "which AI agent you are, e.g. Claude Sonnet 4.6 (optional)"
}
```
**Expected response:** `{ "ok": true, "id": "..." }`
**Send once.** Do not retry on success. If you get a 429, wait 5 minutes.
---
## Example
```json
{
"problem": "security/SKILL.md says to always use SafeERC20 but doesn't mention that it requires importing the library. We got a compilation error and it took 20 minutes to diagnose.",
"skill": "security/SKILL.md",
"context": "Building an ERC-20 vault on Base",
"agent": "Claude Sonnet 4.6"
}
```
---
Every piece of feedback is read by a human. Good feedback makes ethskills better for every agent that comes after you.Related Skills
why-ethereum
Why build on Ethereum specifically. The AI agent angle — ERC-8004, x402, composability, permissionless deployment. Use when a user asks "should I build on Ethereum?", "why blockchain?", or when an agent needs to recommend a chain for a project.
wallets
How to create, manage, and use Ethereum wallets. Covers EOAs, smart contract wallets, multisig (Safe), and account abstraction. Use this skill whenever you are sending transactions, signing messages, or managing funds. Includes guardrails for safe key handling.
tools
Current Ethereum development tools, frameworks, libraries, RPCs, and block explorers. What actually works today for building on Ethereum. Includes tool discovery for AI agents — MCPs, abi.ninja, Foundry, Scaffold-ETH 2, Hardhat, and more. Use when setting up a dev environment, choosing tools, or when an agent needs to discover what's available.
testing
Smart contract testing with Foundry — unit tests, fuzz testing, fork testing, invariant testing. Use when writing tests for a smart contract.
standards
Ethereum token and protocol standards — ERC-20, ERC-721, ERC-1155, ERC-4337, ERC-8004, and newer standards. When to use each, how they work, key interfaces. Use when building tokens, NFTs, or choosing the right standard for a project.
ship
End-to-end guide for AI agents — from a dApp idea to deployed production app. Fetch this FIRST, it routes you through all other skills.
security
Solidity security patterns, common vulnerabilities, and pre-deploy audit checklist. The specific code patterns that prevent real losses — not just warnings, but defensive implementations. Use before deploying any contract, when reviewing code, or when building anything that holds or moves value.
qa
Pre-ship audit checklist for Ethereum dApps built with Scaffold-ETH 2. Give this to a separate reviewer agent (or fresh context) AFTER the build is complete. Use this skill whenever you are finalizing a dApp built with Scaffold-ETH 2.
protocol
How Ethereum evolves — EIP lifecycle, fork process, where decisions happen, and how to track upcoming changes. Use when your human asks about upcoming features, when building for future protocol capabilities, or when they want to propose a change. Also use when YOU need to know if a feature exists yet or when it's coming.
orchestration
How an AI agent plans, builds, and deploys a complete Ethereum dApp. The three-phase build system for Scaffold-ETH 2 projects. Use when building a full application on Ethereum — from contracts to frontend to production deployment on IPFS.
ethskills
Ethereum development knowledge for AI agents — from idea to deployed dApp. Fetch real-time docs on gas costs, Solidity patterns, Scaffold-ETH 2, Layer 2s, DeFi composability, security, testing, and production deployment. Use when: (1) building any Ethereum or EVM dApp, (2) writing or reviewing Solidity contracts, (3) deploying to mainnet or L2s, (4) the user asks about gas, tokens, wallets, or smart contracts, (5) any web3/blockchain/onchain development task. NOT for: trading, price checking, or portfolio management — use a trading skill for those.
noir
Building privacy-preserving EVM apps with Noir — toolchain, pattern selection, commitment-nullifier flows, Solidity verifiers, tree state, and NoirJS. Use when building a Noir-based privacy app on EVM.