kapi WorksDocs

For AI agents

The prompt and example course for each type, the policy prompt and example policies, the Build section as plain text, the JSON Schemas and the docs MCP server.

Everything here is public and needs no key. An AI that writes a course or a policy reads the same rules and checks as Works Studio.

Prompts and example courses

Each course type has a prompt for your own AI and an example course: a whole course of that type for a made-up company, as one kapi.works.bundle/1 bundle. Give your AI both. It copies the example's layout, not its words.

Plain text

  • /build/llms.txt lists every page of this section with a one-line description, following llmstxt.org.
  • /build/llms-full.txt holds the whole section in one file: the course types and their prompts, the format reference, every check and the addresses of the example courses. Each prompt asks the AI to read it when it can open web pages.
  • Add .md to any page's address for its Markdown, such as /build/quickstart.md, or send Accept: text/markdown. Copy page copies it.

Policies

Policies have one prompt for any policy, and Kapi's six example policies, each the canonical file exactly as Kapi stores it. /build/policies/llms.txt holds the whole policy format in one file: the elements Kapi keeps, the place to sign, the two tags, what Kapi leaves out, the prompt, the examples' addresses and Kapi's example code of conduct in full. The prompt asks the AI to read it when it can open web pages.

JSON Schemas

Each data file can name its schema in "$schema", so editors and tools check it as you type. Any site may fetch them.

SchemaFor
https://docs.kapiworks.com/schemas/package-2.jsonKapi Works package (kapi-works.json)
https://docs.kapiworks.com/schemas/content-2.jsonKapi Works content (content.json)
https://docs.kapiworks.com/schemas/questions-2.jsonKapi Works questions (questions.json)
https://docs.kapiworks.com/schemas/words-1.jsonKapi Works words (words/<language>.json)
https://docs.kapiworks.com/schemas/support-1.jsonKapi Works support (support.json)
https://docs.kapiworks.com/schemas/theme-1.jsonKapi Works theme (look/theme.json)
https://docs.kapiworks.com/schemas/bundle-1.jsonKapi Works bundle

For code, kapi-works-package.d.ts holds the types of the data files.

Docs MCP server

The docs MCP server at https://docs.kapiworks.com/api/mcp has three tools for courses and one for policies:

ToolWhat it does
get_course_typeReturns a course type's page, with its prompt, and its example course.
get_schemaReturns the JSON Schema of one data file, or of a bundle.
get_checkReturns a check's page: what its finding means and how to fix it.
get_policy_formatReturns the whole policy format, the prompt and Kapi's example code of conduct.

On this page