Repository navigation
[Phase 1] Agent-native discovery and compatibility #33
Description
Depends on
-
Epic [Epic] SkillX Marketplace & Agent-Native Platform Roadmap #31
-
Phase 0 [Phase 0] Foundations and protected data boundaries #32
Objective
Make SkillX equally useful to humans and agents for discovery, inspection, and compatibility reasoning.
Scope
- Compatibility-aware search/detail UI and API.
- Declared vs verified support.
- Structured CLI JSON output.
- Remote read-only MCP.
- WebMCP read tools as progressive enhancement.
- Markdown variants of public content routes.
- Copy Markdown,
llms.txt,llms-full.txt, canonical/sitemap work.
Implementation tasks
- Add
--compatible <runtime>search filter. - Add
skillx inspect. - Add
skillx check --target. - Standardize CLI JSON/error envelope/exit codes.
- Add compatibility badges with evidence details.
- Build remote MCP package/server.
- Implement
search_packages,get_package,get_release,check_compatibility,get_kit. - Add WebMCP feature detection and read tools.
- Implement route-level Markdown renderers.
- Add
Link: rel=alternate/canonical behavior where appropriate. - Add Copy page as Markdown.
- Add authorization-aware Copy SKILL.md.
- Add
/llms.txtand/llms-full.txt. - Add publisher/harness landing docs.
- Add parity tests across API/CLI/MCP/Markdown.
Acceptance criteria
An agent can discover a package, inspect requirements, see evidence, and understand incompatibility without scraping HTML.
Browser support for WebMCP is optional; normal web remains fully functional.
Activity
docs(plans): record slices 6-7, the remote migration, and task 14
docs(web): add publisher and harness landing pages
mrgoonie commentedon Oct 20, 2026
Production receipt (2026-10-20)
Delivered by #97 (squash 79f98fb). It went through 3 isolated review rounds; the last was CLEAN at 2be37c3.
runCommand. There is noprocess.exiton command paths. The exit codes are 0 ok, 2 usage, 3 not found, 5 auth, and 7 rate limited (including a registry 429 on install, update, sync, promote and publish).get_kit.get_releaseandget_package. They mirrorPOST /api/mcpwith the same names, schemas and access codes.pnpm testreported 116 files, 2357 passed and 2 skipped. Typecheck and build passed.Production (worker version 7d29ff0a, smoke at 09:57 +07):
tools/listlistssearch_packages,get_package,get_release,check_compatibilityandget_kit.get_release {package: "@bestagentkits/plan", version: "0.1.0"}is found, with releaseDigestsha256:08b0fce1…cbac65, state published.get_packagereturns a live listing slug as found.get_kitreturnsnot_foundfor anonymous callers andfoundfor the owner key (a private kit, effective revision 2).The CLI ships to npm when the next release-please PR merges.