Install the CLI
0.36.0 or later. If to11 version prints an older one, upgrade with the same tool you installed it with: brew upgrade to11ai/tap/to11, sudo apt update && sudo apt install --only-upgrade to11, or sudo dnf upgrade to11.
Set up this machine
Run this from your home directory, not inside a git repository:to11 links your home to a project and fetches its skills, asking one question at a time in the terminal:
- At
Press Enter to continue in your browser, or Ctrl-C to cancel., press Enter and sign in in the browser. - At
Which project?, choose the project you will publish to. If it asksWhich organization?first, choose your company’s. - At
All skills are installed, including ones published later:, press Enter for OK. The names under it are the skills the project publishes onlatest. If it saysNo skills published yet.instead, press Enter atInstall new skills automatically?to keep the default, Yes, so the skill you store later in this tutorial arrives. - Check that
Skills are installed for:names Claude Code with~/.claude/skills, and press Enter for OK. If it does not, move to Customize with the arrow keys, press Enter, and select Claude Code. - Answer
ytoInstall the to11 plugin for Claude Code?—for Claude Code and Codex?when Codex is installed too. The plugin keeps your skills current while Claude Code is open. - At
Sync your Claude Code sessions to to11 automatically?, press Enter to keep it off.
✓ Linked skills from <project> @ latest names the project, Saved to the file it wrote, ~/.to11/skills.yaml, and the rows after it are every skill the project has, fetched into place — under a header naming the folders and the agents that read them, one row per skill with its version. Run to11 ui whenever you want to see everything that is set up at once.
See what you received
unchanged — installed and current. A project with no skills yet shows no rows from to11; that is fine, the next step adds one.
Write a skill
A skill is a folder whose entry document isSKILL.md. Create one:
description matters: an agent decides whether a skill is relevant by reading it.
Store it
created tells you this is a new skill rather than a new version of an existing one. If you also kept Codex selected, a second installed line names ~/.agents/skills. The skill is on your machine, and your agent can use it. The last line is the point: storing a version moves the skill’s one label, latest, so everyone who follows the project receives commit-style on their next sync — automatically while their agent is open, or on their next to11 skill sync.
Run to11 skill list again: the row for commit-style reads latest · 1. Your configuration follows latest, which is the version you just stored, so the next version anyone stores reaches you too.
Try it
Open Claude Code and ask it to write a commit message for a change. It picks upcommit-style from its skills directory.
What you did
You configured a machine to receive a project’s skills, and stored a skill that everyone following the project now receives. Every later change works the same way: edit the folder,store, try it.
Next steps
Sessions
Upload your Claude Code sessions and read them in the dashboard.
Publishing skills
Descriptions, reference files, and the other details of storing a version.
Choosing which skills you receive
Disable a skill, hold a version, or share a set with a repository.
What a skill is
The folder format, its limits, and what a skill cannot carry.