SKILL.md for AI Agents

Package your website as a discoverable skill for Claude Code, Cursor, and other coding agents — so they know when and how to use your content.

What is SKILL.md?

SKILL.md is a format for agent skill discovery. Coding agents like Claude Code scan the name and description fields at startup, then activate the full skill body when a matching task comes in.

Think of it as a README for AI agents — it tells them what your site offers, how to connect, and when to use it. Install one file and every coding session has access to your content through MCP tools.

How It Works

1. Crawl

w2agent crawls your site, extracts content, and identifies pages, FAQs, and structure.

2. Generate

A SKILL.md file is generated with MCP connection details, tool descriptions, and content areas.

3. Install

Drop it into ~/.claude/skills/ and every Claude Code session can discover and use your site.

What's Inside

A SKILL.md file contains everything an agent needs:

Frontmattername and description fields — scanned at startup for quick matching.
MCP ConfigJSON connection block so the agent can connect to your MCP server.
ToolsDescriptions of each available tool (list-pages, search-site, get-page, search-faq).
Content AreasKey pages from your site so the agent knows what's available.
UsageStep-by-step workflow instructions for the agent to follow.

Example output

---
name: acme-docs-agent
description: "Use when user asks about Acme. Provides 4 MCP tools for site content and search."
---

# Acme Docs Agent Skill

## Site Overview
- Site: https://docs.acme.com
- Pages indexed: 42
- Description: Developer documentation for the Acme API

## MCP Server Connection

```json
{
  "url": "https://w2agent.dev/api/mcp/docs-acme-com"
}
```

## Available Tools

### `list-pages`
Returns all indexed pages with titles and URLs.

### `search-site`
Full-text search across all indexed pages.

### `get-page`
Fetches the full markdown content of a specific page.

### `search-faq`
Searches FAQ-style content extracted from the site.

## Key Content Areas
- [Getting Started](https://docs.acme.com/getting-started)
- [API Reference](https://docs.acme.com/api)
- [Authentication](https://docs.acme.com/auth)

## Usage Instructions
Use this skill when the user asks about Acme or needs information from https://docs.acme.com.

Workflow:
1. Connect to the MCP server using the configuration above
2. Use `list-pages` to see available content
3. Use `search-site` to find relevant pages by keyword
4. Use `get-page` to retrieve full content for specific pages
5. Use `search-faq` for question/answer lookups

w2agent Hosted Skills

Every site deployed on w2agent gets a skill.md endpoint automatically at /api/sites/{slug}/skill.md. The MCP endpoint is pre-filled — just download and install.

Download and install

curl https://w2agent.dev/api/sites/my-site/skill.md > ~/.claude/skills/my-site/SKILL.md

CLI Generation

Generate a SKILL.md for any URL from the command line. Pass --mcp-endpoint to pre-fill the MCP server connection.

Basic generation

npx w2agent generate https://your-site.com --format skill-md

With MCP endpoint

npx w2agent generate https://your-site.com --format skill-md --mcp-endpoint https://w2agent.dev/api/mcp/your-site

Get Started

Run an audit to see your AI readiness score, then generate a SKILL.md to make your site discoverable by coding agents.

Audit your site now

Get a free AI readiness score and generate the files your site needs.

Start Free Audit
SKILL.md for AI Agents | w2agent