bot

# Creating a Bot A **Bot** is a plain directory with a `BOT.md` at its root. Once registered, a line starting with `@name` in any chat is handed to a session of its own, which reads `BOT.md` and uses the Bot's files as its long-term context. Its files change only when the user explicitly asks (remember / update / correct / forget), under a short write lock, so parallel sessions keep reading freely. **This skill does one thing: create a new Bot.** Everything you can do *to* an existing Bot is addressed to the Bot itself, not to this command — `@name review` to sweep it, `@name attach <path to SKILL.md>` to give it a tool, `@name export to <path>` to make a shareable copy with no memory in it, `@name <task>` for ordinary work. That is where those instructions live too, so they improve for every existing Bot at once. If the request is about a Bot that already exists, say which `@name` line does it and stop. **Cloning one is not an exception.** "Copy this Bot", "make me another one like it", "turn it into a template" all operate on a Bot that exists, so they are `@name export to <path>` — and they need a session that has read the whole source directory to tell a general procedure from this user's private memory. Say that line and stop; do not scaffold a copy from here. `curl -s {{BASE_URL}}/api/bots` lists registered Bots with their `name`, `description` and absolute `path` — use it to check a new name for clashes. ## 1. Create: align first, write only after confirmation 1....