{"id":51167176,"url":"https://github.com/mlava/agent-ready-skills","last_synced_at":"2026-06-26T20:30:51.786Z","repository":{"id":365338828,"uuid":"1253039179","full_name":"mlava/agent-ready-skills","owner":"mlava","description":"Installable skills for using Agent Ready (https://agent-ready.dev) — the agent-readability scanner. Two skills: agent-ready-api (REST) and agent-ready-mcp (MCP server).","archived":false,"fork":false,"pushed_at":"2026-06-16T23:38:22.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-17T00:24:12.616Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://agent-ready.dev","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlava.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T05:21:08.000Z","updated_at":"2026-06-16T23:38:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mlava/agent-ready-skills","commit_stats":null,"previous_names":["mlava/agent-ready-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mlava/agent-ready-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlava%2Fagent-ready-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlava%2Fagent-ready-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlava%2Fagent-ready-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlava%2Fagent-ready-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlava","download_url":"https://codeload.github.com/mlava/agent-ready-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlava%2Fagent-ready-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34832916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-26T20:30:49.073Z","updated_at":"2026-06-26T20:30:51.769Z","avatar_url":"https://github.com/mlava.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-ready-skills\n\n[Agent Skills](https://www.skills.sh/) for using [**Agent Ready**](https://agent-ready.dev) — the agent-readability scanner that scores any URL against the Vercel Agent Readability Spec, the llmstxt.org standard, and the agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb).\n\nInstall one of the skills below and your AI agent can run scans, fetch results, and search the Agent Ready docs without any further setup.\n\nOr add all three at once with the whole-repo form:\n\n```bash\nnpx skills add mlava/agent-ready-skills\n```\n\nBrowse the rendered docs on skills.sh: \u003chttps://www.skills.sh/mlava/agent-ready-skills\u003e\n\n## Skills\n\n### [`agent-ready-api`](skills/agent-ready-api/SKILL.md)\n\nUse the REST API directly. Best when:\n\n- You don't have an MCP host (you're driving a curl / Node / Python script)\n- You want the leanest possible dependency surface\n- You need a one-shot scan from a CI step, a serverless function, or a notebook\n\nInstall:\n\n```bash\nnpx skills add mlava/agent-ready-skills/skills/agent-ready-api\n```\n\n### [`agent-ready-mcp`](skills/agent-ready-mcp/SKILL.md)\n\nUse the MCP server (`agent-ready-mcp` on npm) inside Claude Desktop, Claude Code, Cursor, Cline, Continue, Goose, or any other MCP host. Best when:\n\n- You already have one of those clients running\n- You want tool-native invocation — no curl, no fetch wiring\n- You want the workflow prompts (`scan`, `interpret_scan`, `remediation_plan`)\n\nInstall:\n\n```bash\nnpx skills add mlava/agent-ready-skills/skills/agent-ready-mcp\n```\n\n### [`agent-ready-cli`](skills/agent-ready-cli/SKILL.md)\n\nUse the `agent-ready` command-line client (`agent-ready-scanner` on npm). Best when:\n\n- The agent can run shell commands and you want one command, zero wiring\n- You don't want to install an MCP server or write fetch/polling code\n- You're scripting — machine-readable `--json` to stdout, distinct exit codes\n\nInstall:\n\n```bash\nnpx skills add mlava/agent-ready-skills/skills/agent-ready-cli\n```\n\n## What is Agent Ready?\n\n[Agent Ready](https://agent-ready.dev) runs ~70 checks across four spec families:\n\n- **Vercel Agent Readability Spec** — 15 site-wide + 23 per-page checks (llms.txt, robots.txt, sitemap.xml, sitemap.md, AGENTS.md, JSON-LD, headings, markdown mirrors, content negotiation, code-block language tags, JS-rendering)\n- **llmstxt.org** — 10 checks against the llms.txt file format\n- **Agent protocols** — MCP server cards (SEP-1649), A2A agent cards, agents.json, agent-permissions.json, UCP, x402, NLWeb\n- **Authentication discovery** — RFC 9728 PRM + RFC 8414 AS metadata, WorkOS `auth.md`\n\nPricing:\n\n| Plan | Price | Pages/scan | Scans | API access |\n|---|---|---|---|---|\n| Free | $0 / month | 25 | 10 / 30 days | No |\n| Pro  | $19 / month | 250 | 50 / month | Yes (10 req/min, 200/day) |\n\nIssue a Pro API key at \u003chttps://agent-ready.dev/dashboard/api-keys\u003e.\n\n## Authentication\n\nAll three skills expect the API key as the environment variable **`AGENT_READY_API_KEY`** (begins with `ar_live_…`).\n\n- For **`agent-ready-mcp`**, set it inside the MCP client's server config — not your shell — so the spawned `npx` process inherits it.\n- For **`agent-ready-api`**, set it in your shell, your `.env`, or wherever the agent picks up environment variables before running curl / fetch.\n- For **`agent-ready-cli`**, set it in your shell or `.env`; the CLI reads it automatically (prefer this over the `--api-key` flag, which leaks through shell history).\n\nThe `ask` tool/command (NLWeb-style search over Agent Ready's docs) is **public** and works without a key.\n\n## Reference\n\n- Browse on skills.sh: \u003chttps://www.skills.sh/mlava/agent-ready-skills\u003e\n- Agent Ready homepage: \u003chttps://agent-ready.dev\u003e\n- API quickstart: \u003chttps://agent-ready.dev/quickstart\u003e\n- API docs: \u003chttps://agent-ready.dev/docs/api\u003e\n- OpenAPI 3.1 spec: \u003chttps://agent-ready.dev/api/v1/openapi.json\u003e\n- MCP server card: \u003chttps://agent-ready.dev/.well-known/mcp/server-card.json\u003e\n- MCP server source: \u003chttps://github.com/mlava/agent-ready-mcp\u003e\n- MCP npm: \u003chttps://www.npmjs.com/package/agent-ready-mcp\u003e\n- CLI source: \u003chttps://github.com/mlava/agent-ready-cli\u003e\n- CLI npm: \u003chttps://www.npmjs.com/package/agent-ready-scanner\u003e\n- Auth walkthrough: \u003chttps://agent-ready.dev/auth\u003e\n- Methodology: \u003chttps://agent-ready.dev/methodology\u003e\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlava%2Fagent-ready-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlava%2Fagent-ready-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlava%2Fagent-ready-skills/lists"}