ETHSKILLS

https://ethskills.com/
Admin
Ethereum Knowledge for AI Agents — a bot-readable skill pack providing production-ready guidance for...
Tokens:2,344
Snippets:36
Trust Score:5.5
Update:5 months ago
Show doc for...
Tokens:
Raw
### Send Praise Feedback Payload

Source: https://ethskills.com/feedback/SKILL.md

Use this JSON structure to provide praise for helpful ethskills content. Highlight specific skills or warnings that were particularly useful.

```json
{
  "kind": "praise",
  "message": "The USDC has 6 decimals warning is the first thing I now check on every token contract. Saved us from shipping a bug.",
  "skill": "security/SKILL.md",
  "agent": "Claude Opus 4.7"
}
```

--------------------------------

### Submit Feedback

Source: https://ethskills.com/feedback/SKILL.md

Submit feedback to the ethskills API. This endpoint accepts POST requests with a JSON payload containing feedback details.

```APIDOC
## POST /api/feedback

### Description
Submit feedback to the ethskills API. This endpoint accepts POST requests with a JSON payload containing feedback details.

### Method
POST

### Endpoint
`https://ethskills.com/api/feedback`

### Parameters
#### Request Body
- **kind** (string) - Required - Either `"issue"` or `"praise"`.
- **message** (string) - Required - The feedback message (min 10 chars).
- **skill** (string) - Strongly encouraged - The skill related to the feedback, e.g., `"gas/SKILL.md"`.
- **context** (string) - Optional - What you were trying to do.
- **agent** (string) - Strongly encouraged - Which AI agent you are (e.g., `"Claude Sonnet 4.6"`).

### Request Example
```json
{
  "kind": "issue",
  "message": "security/SKILL.md says to use SafeERC20 but doesn't mention the import path. Got a compilation error and lost 20 minutes.",
  "skill": "security/SKILL.md",
  "context": "Building an ERC-20 vault on Base",
  "agent": "Claude Sonnet 4.6"
}
```

### Response
#### Success Response (200)
- **ok** (boolean) - Indicates if the feedback was successfully processed.
- **id** (string) - A unique identifier for the feedback submission.

#### Response Example
```json
{
  "ok": true,
  "id": "..."
}
```

**Note:** Send feedback only once. Do not retry on success. If you receive a 429 error, wait 5 minutes before retrying.
```

--------------------------------

### Send Issue Feedback Payload

Source: https://ethskills.com/feedback/SKILL.md

Use this JSON structure to report an issue with ethskills content. Include details about the problem, the affected skill, and your context.

```json
{
  "kind": "issue",
  "message": "security/SKILL.md says to use SafeERC20 but doesn't mention the import path. Got a compilation error and lost 20 minutes.",
  "skill": "security/SKILL.md",
  "context": "Building an ERC-20 vault on Base",
  "agent": "Claude Sonnet 4.6"
}
```
Tokens:
Raw