For AI agents

Take these katas to your AI

Every kata on this site is also a skill file — the same guide content, packaged so an AI agent can use it directly instead of you re-explaining the method every time.

Discovery is always free and open, no account needed — the public GitHub repository, the /llms.txt manifest, and the MCP server all work anonymously. Downloading through this site — one kata or the full zip — needs a free account.

1 · What this is

What a skill file is

A skill file is a plain markdown file with a short header (its name and a one-line description) followed by the kata’s full guide: what it is, when to use it, how to fill it in, what good looks like, common mistakes, and where AI actually helps versus where judgement stays with you. Point your AI tool at it and it can apply the method correctly, instead of improvising from whatever it half-remembers about lean or continuous improvement.

2 · Three ways to get them

Download, or stay in sync

One kata at a time — free account required

Every kata’s guide page has a “Skill file ↓” button. Good for handing a single method to your AI as you need it.

Every kata at once — free account required

One zip with every skill file, each in its own folder.

Download all skill files (.zip)

Clone the public repository — always free, no account

The same files, kept in sync automatically as katas are added or updated — clone it once and pull for updates, rather than re-downloading.

git clone https://github.com/Katafacts/skills.git

Browse the repository on GitHub →

3 · Using the file

Where the download goes

A single kata’s download is named <slug>.SKILL.md — for example, a3.SKILL.md. Most AI tools that read skill files expect a folder named after the skill containing a file literally called SKILL.md, so rename and move it — e.g. into a3/SKILL.md. The bulk zip already has this exact shape: unzip it and every folder is ready to use as-is.

4 · Where this goes

Using it with your AI tool

Claude Code
Drop the folder into your project’s .claude/skills/ directory.
Claude.ai or ChatGPT
Upload the SKILL.md file as project knowledge, or paste its contents directly into the chat.
An agent or MCP-compatible host
Skip the download entirely, no account needed — the /llms.txt manifest lists every kata, and the read-only Katafacts MCP server lets an agent browse and fetch the catalogue live and programmatically. Setup steps for Claude and other MCP clients are below.

5 · Connect it live

Katafacts as an MCP server

Beyond the skill files, Katafacts runs a live MCP server at https://www.katafacts.com/api/mcp. Connect it once and your AI can browse the full catalogue, pull any kata’s guide, and check playbooks and linked resources on demand — no re-explaining the method, no manual re-download when a kata is updated.

No account, no API key, nothing to configure on our end. It’s Streamable HTTP transport, read-only, and completely unauthenticated — every tool call is a public, anonymous read over the same content this site already shows anyone. Your AI client may still show a generic warning for any custom connector it doesn’t recognize; that’s standard for all third-party connectors, not specific to Katafacts.

Claude Code

Claude Code is Anthropic’s command-line tool, so if you use it you already have a terminal window open — that’s where you type claude to start it. No terminal open? On Windows, search for “PowerShell” from the Start menu. On a Mac, press ⌘+Space and type “Terminal.” Type the command below at that same prompt — not inside a chat with Claude. It’s identical on Windows and Mac:

claude mcp add --transport http --scope user katafacts https://www.katafacts.com/api/mcp

--scope user means Katafacts is available every time you use Claude Code, in any folder — this only needs to be run once, ever, on a given computer. Leaving it off instead connects Katafacts only to the one project folder you happened to be in when you ran the command.

Working in a shared team codebase and want everyone who opens it to get Katafacts automatically, instead of each person running the command above themselves? Check this into the project’s .mcp.json file instead:

{
  "mcpServers": {
    "katafacts": {
      "type": "http",
      "url": "https://www.katafacts.com/api/mcp"
    }
  }
}

Claude.ai and Claude Desktop

Settings → Connectors → Add custom connector, then paste in the server URL above and confirm. No OAuth step — since there’s no auth to complete, it connects immediately.

Microsoft Copilot Studio

On your agent’s Tools page: Add a tool → New tool → Model Context Protocol. Enter the server URL above as the Server URL, give it a name and description, and set Authentication to None. Copilot Studio’s MCP support is Streamable HTTP only — this server already speaks that, no custom connector or OpenAPI schema needed.

Any other MCP-compatible client

Point it at the same URL over Streamable HTTP — most config files use a shape close to the .mcp.json snippet above. No headers, tokens, or handshake required beyond standard MCP initialization.

Four tools are exposed, all read-only:

list_katas — browse or search the catalogue by name, family, domain, or format.
get_kata_guide — a kata’s full companion guide as markdown, plus a link to its worked example in the house file format.
list_playbook_katas — the ordered katas in a curated playbook.
get_kata_resources — supplementary files and images linked to a kata (downloading the actual file still needs a free account — browsing what exists doesn’t).