fix(skills): update discovery to v0.2

[onmax]

follow up from #1297 by @HugoRCD

• replaces the v0.1 /.well-known/skills/index.json discovery shape with the v0.2 /.well-known/agent-skills/index.json endpoint
• adds the required $schema, type, url, and digest fields
• publishes single-file skills as skill-md artifacts and multi-file skills as .tar.gz archives
• updates English and French docs to describe the v0.2 discovery format

Warning

This intentionally drops v0.1 compatibility. The old /.well-known/skills/* routes are no longer registered.

[vercel]

@onmax is attempting to deploy a commit to the NuxtLabs Team on Vercel.

A member of the Team first needs to authorize it.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/create-docus@1345

npm i https://pkg.pr.new/docus@1345

commit: 840511f

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docus	Ready	Preview	Apr 20, 2026 10:33am

[HugoRCD]

@onmax Do you have a link to that new spec? And do you have any idea why the CLI command is throwing that error even though the endpoint exists?

[onmax]

The v0.2 spec: https://github.com/cloudflare/agent-skills-discovery-rfc

The CLI error has been fixed. This now works

npx skills@1.5.21 add https://docus-git-fork-onmax-fix-agent-skills-v0-2-nuxtlabs.vercel.app --list

updating pr now :)

[larbish]

The v0.2 spec seems still in draft ATM: https://github.com/cloudflare/agent-skills-discovery-rfc

Let's wait until officially published

[onmax]

One thing to flag: v0.1 is also marked as a draft—the RFC changelog describes it as the initial draft, and there hasn’t been a stable discovery release yet. Docus is therefore already implementing a draft version.

The skills CLI currently supports both v0.1 and v0.2. Would keeping the v0.1 endpoints as a compatibility fallback while adding v0.2 address the concern better than waiting for a stable release with no published timeline? just my 2c