docus-playground

Verifies Docus agent skills discovery endpoints under /.well-known/skills/.

3.0k|283|Updated Nov 12, 2020

Search Tags:#endpoint verification #Testing #Documentation #well-known #skills discovery #docus

One-click install

npx skills add https://github.com/nuxt-content/docus --skill docus-playground

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: docus-playground
Source: https://github.com/nuxt-content/docus/tree/main/playground/skills/docus-playground
Command: npx skills add https://github.com/nuxt-content/docus --skill docus-playground

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When building or testing a Docus documentation site, you need a quick way to confirm that the agent skills discovery feature correctly publishes skills via the /.well-known/skills/ routes. This sample skill provides a known fixture to validate that behavior.

Core Features & Use Cases

Discovery Endpoint Testing: Confirms that GET /.well-known/skills/index.json lists the published skill.
File Serving Verification: Checks that SKILL.md and nested reference files are served correctly at their well-known URLs.
Use Case: While developing a Docus site, request the well-known skills endpoints and compare responses against this sample skill to ensure the discovery feature works before publishing real skills.

Quick Start

Ask the assistant to fetch /.well-known/skills/index.json and verify that the docus-playground skill and its reference file are served correctly.

Frequently Asked Questions about docus-playground

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I test Docus agent skills discovery endpoints?▼

Request GET /.well-known/skills/index.json to confirm the skill is listed, then fetch /.well-known/skills/docus-playground/SKILL.md and the references/example.md file to verify file serving works.

What is the /.well-known/skills/ route in Docus?▼

It is a well-known URL path where a Docus site publishes agent skills for discovery. It exposes an index.json listing available skills and serves each skill's SKILL.md and nested files.

Does Docus support nested files in published skills?▼

Yes. Nested files such as references/example.md are served under the skill's well-known path, for example /.well-known/skills/docus-playground/references/example.md.

Why is my skill not listed in skills index.json?▼

The skill directory must contain a SKILL.md file with valid frontmatter including name and description. Verify the file exists at the skill root and that the Docus site has been rebuilt or restarted.