agent-ready-agent-skills — Claude Code skill: setup and usage
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.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a claude-codeWhat agent-ready-agent-skills 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.
What it helps with
- 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 for the agent
- Generate
/.well-known/agent-skills/index.jsonfollowing the RFC v0.2.0 format - Add a
skill-mdentry with an artifact URL and its SHA-256 digest - Run a scan via
https://isitagentready.com/api/scanto verify our endpoint
How to install agent-ready-agent-skills
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a claude-code2Manually: put the files in place
~/.claude/skills/agent-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a codex2Manually: put the files in place
.agents/skills/agent-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a cursor2Manually: put the files in place
.cursor/skills/agent-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/agent-skills2Manually: put the files in place
.github/skills/agent-skills/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/agent-skillsManually: put the files in place
.devin/skills/agent-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-ready-agent-skills
How do I install agent-ready-agent-skills in Claude Code?
Run npx skills add fabricioctelles/skills --skill agent-skills -a claude-code. The file will be placed at ~/.claude/skills/agent-skills/SKILL.md.
What does agent-ready-agent-skills do?
It provides instructions to implement and publish an agent discovery index at /.well-known/agent-skills/index.json.
How do you verify the discovery index?
Send a POST request to https://isitagentready.com/api/scan containing your domain and verify that checks.discovery.agentSkills.status is set to pass.
Source text
SKILL.md · Apache-2.0
---
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"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills