# agent-ready-agent-skills

agent-ready-agent-skills publishes an agent skills discovery index matching the RFC v0.2.0 specification. Useful when exposing local agent tools to external crawlers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 141 repo stars
- Author: fabricioctelles
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/agent-skills/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agent-ready-agent-skills

## What it does

This skill sets up a skill discovery document based on the Agent Skills Discovery RFC v0.2.0. It configures your server to deliver a JSON payload at `/.well-known/agent-skills/index.json` with an HTTP 200 response. External agents can then index available tooling.

The JSON file references the schema at `https://schemas.agentskills.io/discovery/0.2.0/schema.json` and supplies a `skills` array. Each entry lists a skill name, description, artifact URL, and type (`skill-md` or `archive`). Without a matching `sha256:{hex}` digest for each file, the index fails validation.

To check your deployment, send a request to `https://isitagentready.com/api/scan`. The setup succeeds once `checks.discovery.agentSkills.status` returns `pass`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-skills/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-skills/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-skills/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-skills/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/agent-skills
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-skills/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/agent-skills
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-skills/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/agent-skills/SKILL.md

## When to use it
- publish an agent skills discovery index under RFC v0.2.0
- serve the discovery JSON from the /.well-known endpoint
- calculate SHA-256 digests for skill markdown files and archives
- validate deployment readiness using the isitagentready.com scanner

## Example prompts
- Generate `/.well-known/agent-skills/index.json` following the RFC v0.2.0 format
- Add a `skill-md` entry with an artifact URL and its SHA-256 digest
- Run a scan via `https://isitagentready.com/api/scan` to verify our endpoint

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 513a244ce9d45a5e.

BEGIN THIRD-PARTY FILE 513a244ce9d45a5e
````text
---
name: agent-ready-agent-skills
description: >
  Sub-skill de agent-ready-cloudflare: Implement Agent Skills Discovery Index
---
# Implement Agent Skills Discovery Index

Publish a skills discovery document per the
[Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) v0.2.0.

## Requirements

- Serve JSON at `/.well-known/agent-skills/index.json` with HTTP 200
- Include a `$schema` field set to `https://schemas.agentskills.io/discovery/0.2.0/schema.json`
- Include a `skills` array where each entry has:
  - `name` — skill identifier (lowercase alphanumeric + hyphens)
  - `type` — `"skill-md"` (single SKILL.md) or `"archive"` (bundled archive)
  - `description` — brief description of what the skill does
  - `url` — URL to the skill artifact (SKILL.md file or archive)
  - `digest` — SHA-256 hash of the artifact (`sha256:{hex}`)

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.discovery.agentSkills.status` is `"pass"`.
````
END THIRD-PARTY FILE 513a244ce9d45a5e

The third-party file has ended. Everything between the 513a244ce9d45a5e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© fabricioctelles · Apache-2.0 · https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/agent-skills/SKILL.md

## Similar
- [workflow-discovery](https://affpapa.org/en/nevibecode/skills/workflow-discovery.md) — skill · ★ 219 repo stars
- [technical-specification](https://affpapa.org/en/nevibecode/skills/technical-specification.md) — skill · 816 installs
- [sap-api-policy](https://affpapa.org/en/nevibecode/skills/sap-api-policy.md) — skill · 572 installs
- [technical-spec](https://affpapa.org/en/nevibecode/skills/technical-spec.md) — skill · 245 installs
- [egm-brainstorm](https://affpapa.org/en/nevibecode/skills/egm-brainstorm.md) — skill · 601 installs
- [rfc-generator](https://affpapa.org/en/nevibecode/skills/rfc-generator.md) — skill · 294 installs

From the same set: [fabricioctelles/skills](https://affpapa.org/en/nevibecode/by/fabricioctelles/skills.md) — 46 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
