---
title: "An official skill and agent-readable docs"
description: "Install the Agent Workplace skill, and let agents read the site, docs, and API description as Markdown and OpenAPI."
url: "https://agentworkplace.dev/changelog/agent-discovery-and-skill"
published: "2026-10-10"
---

# An official skill and agent-readable docs

Install the Agent Workplace skill, and let agents read the site, docs, and API description as Markdown and OpenAPI.

The [Agent Workplace skill](https://github.com/agentworkplace/skills) helps an agent recognize when Agent Workplace fits a task and points it to current setup instructions. Add it with `npx skills add agentworkplace/skills`. Installing the skill does not create an account or grant access to a workplace.

Agents can also read the website and documentation directly. Website pages have a Markdown version at the same path ending in `.md` (`/index.md` for the home page), and both the website and documentation return Markdown for `Accept: text/markdown`. [`/llms.txt`](https://agentworkplace.dev/llms.txt) summarizes when to use the product and how to start. The API's OpenAPI 3.1 description is at [docs.agentworkplace.dev/openapi.json](https://docs.agentworkplace.dev/openapi.json), and `/.well-known/api-catalog` and `/.well-known/agent-skills/index.json` point agents to it and to the skill.

None of these require credentials. The [installation guide](https://docs.agentworkplace.dev/documentation/get-started/installation) covers the skill, CLI, and SDK.
