Skip to content

docs: correct skill discovery URL format and manifest documentation#10756

Open
IamCoder18 wants to merge 1 commit into
Kilo-Org:mainfrom
IamCoder18:docs/fix-skill-url-format
Open

docs: correct skill discovery URL format and manifest documentation#10756
IamCoder18 wants to merge 1 commit into
Kilo-Org:mainfrom
IamCoder18:docs/fix-skill-url-format

Conversation

@IamCoder18
Copy link
Copy Markdown
Contributor

Issue

Fixes #10755

Context

The documentation incorrectly stated that skills.urls accepts direct URLs to individual SKILL.md files. In reality, the skill discovery implementation requires URLs pointing to a directory that serves an index.json manifest. Fixed the docs to correctly reflect the implemented behavior.

Implementation

Updated packages/kilo-docs/pages/customize/skills.md in both the VSCode and CLI tabs to show the correct URL format (https://example.com/.well-known/skills/) and added documentation explaining the required index.json manifest structure with name, description, and files fields. Files are downloaded from {url}/{skill-name}/{file} paths - this matches the actual implementation in packages/opencode/src/skill/discovery.ts which fetches the index, then downloads each skill's files.

Screenshots / Video

before after
image chrome_K5me9Dr0qY

How to Test

Manual/local verification

Ran the docs site and verified the information was accurate.
I also run build and test for the docs site and it passed.

Reviewer test steps

  1. Run the docs site cd packages/kilo-docs/ && bun run dev
  2. Verify /docs/customize/skills#additional-skill-paths-and-remote-urls contains accurate information

Checklist

  • Issue linked above, or exception explained
  • Tests/verification described
  • Screenshots/video included for visual changes, or marked N/A
  • Changeset considered for user-facing changes
  • I personally reviewed the diff and can explain the changes, including any AI-assisted work.

Get in Touch

Discord: @IamCoder18

@vercel
Copy link
Copy Markdown

vercel Bot commented May 30, 2026

@IamCoder18 is attempting to deploy a commit to the Kilo Code Team on Vercel.

A member of the Team first needs to authorize it.

@kilo-code-bot
Copy link
Copy Markdown
Contributor

kilo-code-bot Bot commented May 30, 2026

Code Review Summary

Status: No Issues Found | Recommendation: Merge

The documentation changes accurately reflect the actual implementation in packages/opencode/src/skill/discovery.ts. Verified:

  • URL format (https://example.com/.well-known/skills/) matches how discovery.ts normalizes the base URL and appends index.json (line 56)
  • The index.json structure ({ skills: [{ name, files }] }) exactly matches the IndexSkill and Index schemas (lines 12-19)
  • The files must include SKILL.md requirement is enforced at line 76 of discovery.ts
  • The {url}/{skill-name}/{file} download path pattern matches the URL construction at line 91
Files Reviewed (1 file)
  • packages/kilo-docs/pages/customize/skills.md

Reviewed by claude-4.6-sonnet-20260217 · 587,607 tokens

Review guidance: REVIEW.md from base branch main

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: skills.md remote url documentation is misleading

1 participant