# is-agentic

The is-agentic Claude Code skill scores how ready a website, domain, or public MCP endpoint is for AI agents. It can fetch a report or help address the issues behind a score.

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

## What it does

The skill audits a public URL and returns an agent-readiness score from 0 to 100, with scan evidence and suggested fixes. It can request a score, retrieve a JSON report, or work through the findings.

For a CLI check, it runs `npx is-agentic <domain> --json`. The command returns a stored report or starts a scan and waits for it to finish. The API reads completed reports only; the MCP endpoint also exposes tools for reports, methodology, and developer documentation. These interfaces are free and require no API key.

Reports belong to an exact URL: `example.com/docs` and `example.com` are separate targets. The CLI can return the existing snapshot after a fix; compare `scanned_at`, since reports refresh on access only when they are older than 6 hours.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel/vercel-plugin --skill is-agentic -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel/vercel-plugin --skill is-agentic -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel/vercel-plugin --skill is-agentic -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vercel/vercel-plugin skills/is-agentic
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel/vercel-plugin --skill is-agentic -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vercel/vercel-plugin --path skills/is-agentic
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vercel/vercel-plugin --skill is-agentic -a opencode
```

### 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/vercel/vercel-plugin/tree/HEAD/skills/is-agentic/SKILL.md

## When to use it
- score a public site for AI-agent readiness
- retrieve a domain's stored score as JSON
- identify issues that lower a site's score
- use scan recommendations to address reported issues

## Example prompts
- Check `example.com` for AI-agent readiness and return the JSON report.
- Fetch the Is Agentic report for `https://example.com/docs`.
- Review the findings for `example.com` and apply the suggested fixes.

## 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: 5871712b0770dc11.

BEGIN THIRD-PARTY FILE 5871712b0770dc11
````text
---
name: is-agentic
description: Score how ready a website, domain, or public MCP endpoint is for AI agents using Is Agentic, and read or act on the resulting report. Use when asked to check a site's agent readiness, get its Is Agentic score, fetch a scored report as JSON, or fix the issues that lower a site's score.
metadata:
  priority: 4
  docs:
    - "https://is-agentic.com/docs"
    - "https://is-agentic.com/llms.txt"
  bashPatterns:
    - '\bnpx\s+is-agentic\b'
    - '\bbunx\s+is-agentic\b'
    - '\bskills\s+add\s+vercel-labs/is-agentic\b'
    - '\bcurl\s+[^\n]*is-agentic\.com/api\b'
---

# Is Agentic

Is Agentic runs a technical audit of a public URL and publishes a 0 to 100 agent-readiness score with evidence-backed issues and recommended fixes. All interfaces below are public, read-only, and free; none needs an API key.

## Get a score

Default: the official CLI. It returns a stored report immediately, or starts a scan and waits when none exists.

```sh
npx is-agentic <domain> --json
```

Omit `--json` only when a human is reading the terminal output.

When you cannot run commands, use the read-only API instead. It never starts a scan; a 404 means no completed report exists yet.

```
GET https://is-agentic.com/api/v1/report?url=<url-encoded-target>
```

MCP hosts can connect to the Streamable HTTP endpoint `https://is-agentic.com/mcp` and call `is_agentic_get_report`, `is_agentic_get_methodology`, or `is_agentic_get_developer_docs`.

## Read a report

The JSON response is a `PublicScanReport`:

- `score`: 0 to 100, or `null` when the target could not be scored (for example an MCP server that requires authentication). `score_label` explains a null score.
- `score_breakdown.essential` and `.recommended`: each has `earned`, `available`, `passing`, `total`. Essential checks are the ones that matter most; a site can look polished and still fail them.
- `score_breakdown.bonus`: `points` and `positive_signals`. Bonus is additive and never required; do not treat missing bonus signals as defects.
- `issues[]`: each has `id`, `name`, `tier` (`essential` | `recommended` | `bonus`), `result` (`failed` | `partial`), `details` (evidence from the scan), and `recommendation` (the fix). 
- `report_url`: the canonical human-readable report. Cite it when reporting a score to a person.
- `scanned_at`: when the audit ran. Reports are immutable snapshots.

## Improve a site's score

1. Fetch the report for the exact target you are improving.
2. Work through `issues` in this order: `essential` failures, `essential` partials, then `recommended`. Ignore `bonus` unless everything else passes.
3. For each issue, `details` says what the scan observed and `recommendation` says what to change. Prefer the recommendation; it was written against the actual evidence.
4. After deploying fixes, get a fresh score and compare `scanned_at` to confirm you are not reading the old snapshot (see gotchas).

## Errors
````
END THIRD-PARTY FILE 5871712b0770dc11

The third-party file has ended. Everything between the 5871712b0770dc11 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.

First 2937 of 4127 bytes. © vercel · Apache-2.0 · https://github.com/vercel/vercel-plugin/tree/HEAD/skills/is-agentic/SKILL.md

_Part of the page did not fit — see the HTML version._

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