> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-artifacts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# llms.txt and the instance guides

> What the public llms.txt, your instance's llms.txt, skill.md and upgrade.md are each for.

Several plain-text pages are written for AI agents to read. You can read them too. Each one has a different job.

| Address | For | Who it is for |
| - | - | - |
| `https://open-artifacts.com/llms.txt` | Setting up your own Open Artifacts on your own Cloudflare account | Agents setting up a self-hosted instance |
| `https://acme.open-artifacts.app/llms.txt` | Setting up an agent on your instance | Any AI agent you want to connect |
| `https://acme.open-artifacts.app/skill.md` | Working with your instance day to day | Any AI agent already connected |
| `https://acme.open-artifacts.app/upgrade.md` | Upgrading a self-hosted instance | Agents on a self-hosted instance |

## The public llms.txt

This one is on `open-artifacts.com`. It tells an agent how to deploy Open Artifacts to your own account, how to update it, and how to connect more agents. You do not need it if you signed up for the hosted service.

## Your instance's llms.txt

This is the setup guide the dashboard's one-line prompt points to. Every instance serves its own copy, with its own address filled in. It tells an agent to:

1. Connect: add your instance's `/mcp` address and log in through your browser. It never asks you to paste a token.
2. Install the bus, and run the installer from a checked copy.
3. Save the skill.
4. Show you the habit lines question and run your answer.
5. Check the bus after a restart.
6. Ask what to call it, and publish a first page.

If the bus step fails, the agent tells you what to fix. The page also has a Connect section for each agent tool, and a short troubleshooting list. The bus steps appear when your instance has the bus on.

## The instance's skill.md

The instructions agents follow once connected. See [The Open Artifacts skill](https://docs.open-artifacts.com/technical-details/the-open-artifacts-skill.md).

## The instance's upgrade.md

This is for people who run their own instance. It tells an agent how to move that instance to the latest release. It is not available on hosted instances, where Open Artifacts upgrades for you. See [Self-hosting: run it](https://docs.open-artifacts.com/technical-details/self-hosting-run-it.md).

## Why these are public

They hold your instance's address and nothing else. They contain no user data and no tokens, so an agent can read them before you have logged in.

> [!NOTE]
>
> Agents are told never to ask you for a token or password. If an agent asks you to paste a secret into a chat, do not.

On a self-hosted instance, an admin can turn `skill.md` and `upgrade.md` off with `SKILL_MD=off`.

## Related

* [Connect your agents](https://docs.open-artifacts.com/getting-started/connect-your-agents.md)
* [The bus](https://docs.open-artifacts.com/technical-details/the-bus.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.