--- title: "CF-AGENT-SKILLS: Agent Skills index | Agent Ready Checklist" description: "CF-AGENT-SKILLS (CLOUDFLARE, Act layer): Agent Skills index. What it asks, the evidence, the command that verifies it and the fix on 19 platforms." canonical: https://agentreadychecklist.com/checklist/cf-agent-skills site: "Agent Ready Checklist" last_updated: 2026-11-05 section: "Checklist" --- # CF-AGENT-SKILLS: Agent Skills index | Agent Ready Checklist > CF-AGENT-SKILLS (CLOUDFLARE, Act layer): Agent Skills index. What it asks, the evidence, the command that verifies it and the fix on 19 platforms. Source: https://agentreadychecklist.com/checklist/cf-agent-skills Site: Agent Ready Checklist Last reviewed: 2026-11-05 Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search) Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free). # CF-AGENT-SKILLS: Agent Skills index CF-AGENT-SKILLS is a Cloudflare scanner check on the act layer: Publish an Agent Skills discovery index at /.well-known/agent-skills/index.json with $schema, and a skills array of name, type, description, url and sha256 digest. It applies to products that publish task instructions for agents. 19 of 19 platforms have a recipe below, 8 of them workarounds. 3 cited facts back it. ## The requirement Identifier CF-AGENT-SKILLS Level CLOUDFLARE Layer Act Applies to products that publish task instructions for agents Checked by Ora, matched on this site, Cloudflare agentSkills, Verify Kit agent-skills Ora check [agent-skills-index-v2](#ora) The statement Publish an Agent Skills discovery index at /.well-known/agent-skills/index.json with $schema, and a skills array of name, type, description, url and sha256 digest. ## Why - The index follows the Agent Skills Discovery RFC v0.2.0 and its $schema is https://schemas.agentskills.io/discovery/0.2.0/schema.json.primary source: [isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md](https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md), read 2026-11-04 - isitagentready.com publishes its own index with 25 skills, one per standard it checks, read 2026-11-04.primary source, 2026-11-04: [isitagentready.com/.well-known/agent-skills/index.json](https://isitagentready.com/.well-known/agent-skills/index.json), read 2026-11-04 - AgentReady removed its AGENTS.md and SKILLS.md requirement (AR-READ-10) in August 2026, so skills have no AgentReady twin.primary source, 2026-08-26: [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md), read 2026-11-04 ## How to verify ### [Agent Skills index](https://agentreadychecklist.com/kit/agent-skills/) ```bash curl -fsSL https://agentreadychecklist.com/kit/verify.sh | bash -s -- https://example.com --only=agent-skills ``` Fetches /.well-known/agent-skills/index.json, checks $schema and that every skill has name, type, url and a sha256 digest, then fetches one skill url and compares its digest. **It cannot prove:** Does not judge whether the instructions in a skill are correct. ### The one-line version curl -s /.well-known/agent-skills/index.json | jq -e ".skills | length > 0". ## Verify with Ora One check in Ora's catalogue (contract 1.38.0, read 2026-11-05) read this row. Each entry says what the check looks at and why this page lists it. - `agent-skills-index-v2` Agent Skills index conformance (v0.2.0) Looks for /.well-known/agent-skills/index.json against the v0.2.0 schema with typed entries, then verifies one artifact digest. A bonus check, marked emerging. Access, 2 points, bonus, emerging; catalogue applicability domain-only. Listed because: same name, `agent skills`. ### Run just these checks ```bash curl -s -X POST https://ora.ai/api/scan/checks -H 'content-type: application/json' -d '{"url":"https://example.com","checkIds":["agent-skills-index-v2"]}' ``` This calls the endpoint Ora documents for re-verifying a fix. It sends no cache, returns a result for each id and no total score, and spends one scan from the daily budget. Replace the URL with yours. [How to re-verify one fix](https://agentreadychecklist.com/guides/re-verify-one-fix-with-ora/). ### Or audit the whole site ```bash npx ax@0.10 audit https://example.com --min-score 70 ``` Exit code 1 means the score is below the number you passed, so the same line gates a deploy: [the CI recipe](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/). [Why this site recommends Ora, and where it falls short](https://agentreadychecklist.com/verify-with-ora/). ## Fix it on your platform ### Next.js (App Router)recipe Place public/.well-known/agent-skills/index.json with $schema, and a skills array of { name, type, description, url, digest }. Next.js 16.x (npm latest 16.4.5, read 2026-11-04); docs at nextjs.org/docs/app. Read 2026-11-04. [nextjs.org/docs/app/api-reference/file-conventions/public-folder](https://nextjs.org/docs/app/api-reference/file-conventions/public-folder). [All Next.js (App Router) recipes](https://agentreadychecklist.com/platforms/nextjs-app-router/#cf-agent-skills) ### Astrorecipe Place public/.well-known/agent-skills/index.json and the SKILL.md files it lists under public/.well-known/agent-skills/. Astro 7.x (npm latest astro 7.4.5, @astrojs/sitemap 3.7.4, read 2026-11-04). Read 2026-11-04. [docs.astro.build/en/basics/project-structure/](https://docs.astro.build/en/basics/project-structure/). [All Astro recipes](https://agentreadychecklist.com/platforms/astro/#cf-agent-skills) ### Nuxtrecipe Place public/.well-known/agent-skills/index.json and the listed SKILL.md files. Nuxt 4.x (npm latest nuxt 4.6.4, @nuxtjs/robots 7.0.2, @nuxtjs/sitemap 9.1.0, read 2026-11-04). Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public). [All Nuxt recipes](https://agentreadychecklist.com/platforms/nuxt/#cf-agent-skills) ### SvelteKitrecipe Place static/.well-known/agent-skills/index.json and the SKILL.md files. SvelteKit (npm latest @sveltejs/kit 3.1.1, read 2026-11-04); docs at svelte.dev/docs/kit. Read 2026-11-04. [svelte.dev/docs/kit/project-structure](https://svelte.dev/docs/kit/project-structure). [All SvelteKit recipes](https://agentreadychecklist.com/platforms/sveltekit/#cf-agent-skills) ### Remix and React Router (framework mode)recipe Place public/.well-known/agent-skills/index.json or return it from a resource route. React Router framework mode (npm latest react-router 8.5.1; Remix v2 @remix-run/node 2.17.5, read 2026-11-04); docs at reactrouter.com. Read 2026-11-04. [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes). [All Remix and React Router (framework mode) recipes](https://agentreadychecklist.com/platforms/remix-react-router/#cf-agent-skills) ### Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)recipe Upload .well-known/agent-skills/index.json and the SKILL.md files; add .nojekyll on GitHub Pages. Host documentation as published on 2026-11-04 (no version numbers; config files \_headers, \_redirects, vercel.json, 404.html). Read 2026-11-04. [docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site). [All Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront) recipes](https://agentreadychecklist.com/platforms/static-hosting/#cf-agent-skills) ### WordPress and Elementorrecipe Upload `.well-known/agent-skills/index.json` and the SKILL.md files to the web root; the web server serves them without WordPress. Check `Content-Type: application/json`. WordPress 7.1.4 (core release from the version-check API), Elementor 4.3.6 (plugin directory, updated 2026-11-02), Yoast SEO 28.8 noted for llms.txt; docs read 2026-11-04. Read 2026-11-04. [developer.wordpress.org/reference/functions/add\_rewrite\_rule/](https://developer.wordpress.org/reference/functions/add_rewrite_rule/). [All WordPress and Elementor recipes](https://agentreadychecklist.com/platforms/wordpress-elementor/#cf-agent-skills) ### Shopify (Online Store 2.0 themes)workaround No storefront path for /.well-known/agent-skills/. Not possible on this platform; workaround: reference skills from agents.md.liquid, which Shopify serves at /agents.md. Hosted SaaS, Online Store 2.0 Liquid themes, docs read 2026-11-04; storefront behaviour probed live on one Shopify store the same day. Read 2026-11-04. [shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid](https://shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid). [All Shopify (Online Store 2.0 themes) recipes](https://agentreadychecklist.com/platforms/shopify/#cf-agent-skills) ### Webflowworkaround Not hostable on the Webflow origin. Serve /.well-known/agent-skills/index.json from a reverse proxy or Worker that passes other paths to Webflow. Hosted SaaS, help center articles read 2026-11-04 (updated dates 2024-10-14 to 2026-10-29). Read 2026-11-04. [help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow](https://help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow). [All Webflow recipes](https://agentreadychecklist.com/platforms/webflow/#cf-agent-skills) ### Framerrecipe Upload index.json at path /.well-known/agent-skills and each SKILL.md as a Static File; JSON renders in the browser per the doc. Hosted SaaS, help articles read 2026-11-04 (marked updated 2026-09-15). Read 2026-11-04. [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/). [All Framer recipes](https://agentreadychecklist.com/platforms/framer/#cf-agent-skills) ### Wix (Wix Editor and Wix Studio)workaround No /.well-known/ hosting. Not possible on this platform; workaround: link skill files from llms.txt on a domain you control. Hosted SaaS, help center read 2026-11-04. Read 2026-11-04. [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support). [All Wix (Wix Editor and Wix Studio) recipes](https://agentreadychecklist.com/platforms/wix/#cf-agent-skills) ### Squarespace (version 7.1)workaround No /.well-known/ hosting. Not possible on this platform; workaround: link skill files from llms.txt on a domain you control. Hosted SaaS, version 7.1 sites, help center read 2026-11-04 (articles updated 2026-07-17 to 2026-11-03). Read 2026-11-04. [support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file (the article needs a Squarespace sign-in to read)](https://support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file). [All Squarespace (version 7.1) recipes](https://agentreadychecklist.com/platforms/squarespace/#cf-agent-skills) ### HubSpot CMS (Content Hub)workaround Upload index.json to the file manager and redirect /.well-known/agent-skills/index.json to it; strict validators expect a direct 200. Hosted SaaS, Content Hub, knowledge base and developer docs read 2026-11-04. Read 2026-11-04. [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects). [All HubSpot CMS (Content Hub) recipes](https://agentreadychecklist.com/platforms/hubspot-cms/#cf-agent-skills) ### Docusaurusrecipe Publish static/.well-known/agent-skills/index.json with $schema, and a skills array of {name, type, description, url, digest}; add static/.nojekyll on GitHub Pages. 3.10.2 (npm @docusaurus/core latest, read 2026-11-04). Read 2026-11-04. [docusaurus.io/docs/static-assets](https://docusaurus.io/docs/static-assets). [All Docusaurus recipes](https://agentreadychecklist.com/platforms/docusaurus/#cf-agent-skills) ### Mintlifyrecipe Automatic skill.md and an agent-skills index (live at /docs/.well-known/agent-skills/index.json, 2026-11-04). Behind a reverse proxy, route /.well-known/skills/\* to the Mintlify origin. Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [mintlify.com/docs/ai/skillmd](https://mintlify.com/docs/ai/skillmd). [All Mintlify recipes](https://agentreadychecklist.com/platforms/mintlify/#cf-agent-skills) ### GitBookworkaround No agent-skills support is documented for GitBook. Not possible on this platform without outside help. Workaround: publish /.well-known/agent-skills/index.json and the SKILL.md files from your root domain, the same route the AR-FIND-04 recipe takes, and serve the docs under a subdirectory of it. Hosted SaaS, docs read 2026-11-04. Generic step from the AgentReady specification; not platform-specific. [isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md](https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md). [All GitBook recipes](https://agentreadychecklist.com/platforms/gitbook/#cf-agent-skills) ### ReadMerecipe Turn on Agent Skills Index; ReadMe publishes /.well-known/agent-skills/index.json (Agent Skills Discovery v0.2.0). Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [docs.readme.com/main/docs/ai-discoverability](https://docs.readme.com/main/docs/ai-discoverability). [All ReadMe recipes](https://agentreadychecklist.com/platforms/readme/#cf-agent-skills) ### Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround Serve static/.well-known/agent-skills/index.json through ssr.js with the sitemap pattern. Hosted SaaS (B2C Commerce help release 264.0.0); PWA Kit retail-react-app 10.3.0 and pwa-kit-runtime 3.21.0 on npm, read 2026-11-04. Read 2026-11-04. [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html). [All Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront) recipes](https://agentreadychecklist.com/platforms/salesforce-commerce-cloud/#cf-agent-skills) ### Adobe Commerce and Magento Open Sourceworkaround Serve /.well-known/agent-skills/index.json as a static file in pub/ or as a Fastly synthetic response. 2.4.9 (GitHub tag published 2026-05-12; 2.4.10-alpha1 tagged 2026-10-13); release notes read 2026-11-04. Read 2026-11-04. [experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets). [All Adobe Commerce and Magento Open Source recipes](https://agentreadychecklist.com/platforms/adobe-commerce/#cf-agent-skills) ## What it does not do - A skill file tells an agent how; it grants no access. - Not measured in the AgentReady studies. ## Common mistakes - Digest not updated after editing a SKILL.md. - Relative urls without a base. ## Related - Term: [.well-known](https://agentreadychecklist.com/glossary/well-known/) ## Sources - [isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md](https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md)read 2026-11-04 - [isitagentready.com/.well-known/agent-skills/index.json](https://isitagentready.com/.well-known/agent-skills/index.json)read 2026-11-04 - [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md)read 2026-11-04 - [nextjs.org/docs/app/api-reference/file-conventions/public-folder](https://nextjs.org/docs/app/api-reference/file-conventions/public-folder)read 2026-11-04 - [docs.astro.build/en/basics/project-structure/](https://docs.astro.build/en/basics/project-structure/)read 2026-11-04 - [nuxt.com/docs/guide/directory-structure/public](https://nuxt.com/docs/guide/directory-structure/public)read 2026-11-04 - [svelte.dev/docs/kit/project-structure](https://svelte.dev/docs/kit/project-structure)read 2026-11-04 - [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes)read 2026-11-04 - [docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site)read 2026-11-04 - [developer.wordpress.org/reference/functions/add\_rewrite\_rule/](https://developer.wordpress.org/reference/functions/add_rewrite_rule/)read 2026-11-04 - [shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid](https://shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid)read 2026-11-04 - [help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow](https://help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow)read 2026-11-04 - [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/)read 2026-11-04 - [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support)read 2026-11-04 - [support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file (the article needs a Squarespace sign-in to read)](https://support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file)read 2026-11-04 - [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects)read 2026-11-04 - [docusaurus.io/docs/static-assets](https://docusaurus.io/docs/static-assets)read 2026-11-04 - [mintlify.com/docs/ai/skillmd](https://mintlify.com/docs/ai/skillmd)read 2026-11-04 - [docs.readme.com/main/docs/ai-discoverability](https://docs.readme.com/main/docs/ai-discoverability)read 2026-11-04 - [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html)read 2026-11-04 - [experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets)read 2026-11-04 - [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05 - [ora.ai/llms-full.txt](https://ora.ai/llms-full.txt?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05 - [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05 Verify with Ora The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account. `npx ax@0.10 audit --min-score ` [Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/) Fix it on - [Next.js (App Router)recipe](#p-nextjs-app-router) - [Astrorecipe](#p-astro) - [Nuxtrecipe](#p-nuxt) - [SvelteKitrecipe](#p-sveltekit) - [Remix and React Router (framework mode)recipe](#p-remix-react-router) - [Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)recipe](#p-static-hosting) - [WordPress and Elementorrecipe](#p-wordpress-elementor) - [Shopify (Online Store 2.0 themes)workaround](#p-shopify) - [Webflowworkaround](#p-webflow) - [Framerrecipe](#p-framer) - [Wix (Wix Editor and Wix Studio)workaround](#p-wix) - [Squarespace (version 7.1)workaround](#p-squarespace) - [HubSpot CMS (Content Hub)workaround](#p-hubspot-cms) - [Docusaurusrecipe](#p-docusaurus) - [Mintlifyrecipe](#p-mintlify) - [GitBookworkaround](#p-gitbook) - [ReadMerecipe](#p-readme) - [Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround](#p-salesforce-commerce-cloud) - [Adobe Commerce and Magento Open Sourceworkaround](#p-adobe-commerce) Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.