Conversation
Rename the confusing `id`/`name` fields on the Skill interface to `name`/`title`, aligning with the frontmatter fields they map to: - `name` = frontmatter `name` (the slug, e.g. "asset-canister") - `title` = frontmatter `metadata.title` (display name, e.g. "Asset Canister") Remove the `.well-known/agent.json` endpoint: it followed no standard (not A2A, not Agent Skills spec) and no agent consumes it. The llms.txt and raw GitHub URLs are the actual discovery/access paths.
marc0olo
changed the title
… Access page
- Add /.well-known/skills/index.json and per-skill SKILL.md endpoints
implementing the Cloudflare Agent Skills Discovery RFC (v0.1)
- Remove redundant /skills/{name}.md endpoint (superseded by .well-known)
- Simplify robots.txt to wildcard-only (per-bot entries were redundant)
- Rename ApiTab → AccessTab, replace curl commands with plain URLs
marc0olo
changed the title
raymondk
approved these changes
Mar 4, 2026
marc0olo
added a commit
that referenced
this pull request
Mar 4, 2026
Replace stale references to `.well-known/agent.json` and `/skills/{name}.md`
with the new `.well-known/skills/` endpoints. Also rename ApiTab → AccessTab
in project structure, and add agent-first writing callout to CONTRIBUTING.md.
raymondk
pushed a commit
that referenced
this pull request
Mar 4, 2026
Replace stale references to `.well-known/agent.json` and `/skills/{name}.md`
with the new `.well-known/skills/` endpoints. Also rename ApiTab → AccessTab
in project structure, and add agent-first writing callout to CONTRIBUTING.md.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
id/namefields on theSkillinterface toname/title, aligning with the frontmatter fields they actually map to (name= slug,title= display name frommetadata.title).well-known/agent.jsonendpoint — it followed no standard (not A2A, not Agent Skills spec) and no agent auto-discovers or consumes it/.well-known/skills/endpoint implementing the Cloudflare Agent Skills Discovery RFC (v0.1) — servesindex.jsondiscovery index and per-skillSKILL.mdfiles at standardized paths/skills/{name}.mdendpoint — superseded by/.well-known/skills/{name}/SKILL.mdrobots.txttoUser-agent: *+Allow: /+Sitemap:— the per-bot AI crawler entries were redundant with the wildcard ruleApiTab→AccessTaband replacecurlcommands with plain URLs on the Access page, consistent with the rest of the siteFollow-up: URL strategy (domain vs GitHub)
The site currently advertises both domain URLs and raw GitHub URLs depending on context:
dfinity.github.io/icskills/...): Access page endpoints,.well-known/skills/discoveryraw.githubusercontent.com/...):llms.txtlinks, BrowseTab/SkillHeader copy buttons, "How it works" page examplesTwo
npx skills addvariants exist with different resolution paths:npx skills add https://dfinity.github.io/icskills→ domain-based.well-known/skills/discoverynpx skills add dfinity/icskills→ GitHub repo-based discovery (reads skill files directly from the repo)Going forward, consider whether to:
llms.txt, copy buttons, "How it works" examples)This was intentionally left out of this PR to keep scope focused.