Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a claude-code
Open on GitHub

What 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.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

How to install agent-ready-agent-skills

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-agent-skills -a claude-code

2Manually: put the files in place

~/.claude/skills/agent-skills/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set46

The whole set →
agent-ready-content-signals The agent-ready-content-signals skill adds Content Signals to robots.txt, letting you set preferences for AI training, search, and AI input. CX Codex +1 ★ 141repo stars agent-ready-mcp-server-card agent-ready-mcp-server-card — a skill that publishes an MCP Server Card, a JSON file for agent discovery. Use it when running your own MCP server and want tools like isitagentready.com to find and validate it. CX Codex +1 ★ 141repo stars agent-ready-a2a-agent-card agent-ready-a2a-agent-card generates an A2A Agent Card file for agent-to-agent discovery. Useful when setting up agent endpoints on Cloudflare Workers. CX Codex +1 ★ 141repo stars agent-ready-web-bot-auth The agent-ready-web-bot-auth skill guides Web Bot Auth setup so receiving sites can verify bot or agent requests. Use it when your site needs to identify its signed outbound traffic. CX Codex +1 ★ 141repo stars agent-ready-oauth-protected-resource agent-ready-oauth-protected-resource publishes OAuth Protected Resource Metadata so agents can discover how to authenticate. It fits Cloudflare setups that expose a protected resource. CX Codex +1 ★ 141repo stars agent-ready-link-headers agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically. CX Codex +1 ★ 141repo stars agent-ready-markdown-negotiation agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML. CX Codex +1 ★ 141repo stars agent-ready-webmcp agent-ready-webmcp wires a site's actions into the WebMCP API so browser-based AI agents can find and call them. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open