~/.claude/skills months ago, and every copy drifts on its own schedule.
to11 keeps them in one place. A skill is written once and stored as a version in a project. Every developer who follows the project receives it — and receives the next version the same way — without anyone copying a file.
How a skill travels
- Store writes a new immutable version of the whole folder and moves the skill’s one label,
latest, to it. The version lands on your own machine too. Nothing is pinned: your configuration followslatest, which is now this version, and aversion:pin you already had moves to it. - Sync makes a machine match its configuration: a machine following
latestreceives the newest version, and a machine pinned to a version keeps it. It runs when a developer asks for it, and automatically while their agent is open.
Who decides what a machine receives
What a developer receives is decided by configuration files, not by the platform:- A developer’s own file (
~/.to11/skills.yaml) names the projects they follow, and which agents get the files. - A repository’s file (
<repo>/.to11/skills.yaml) is committed, so the skills a team relies on for work in that repository reach everyone who works there — in addition to their own. - Disabling a skill is yours to decide. A developer can decline any skill in their own directories, decline one a repository asks for with
enforced: true, and hold a skill at a version whilelatestmoves on.
Where the files land
The CLI writes each skill where the agent already looks for skills, so there is no agent setting to change:
Both are relative to your home directory for your own skills, and to the repository root for a repository’s.
.agents/skills is the folder the Agent Skills ecosystem shares, so the Codex target reaches more agents than Codex. At home, Cursor, GitHub Copilot and Gemini CLI read their own folders (~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills) instead; point a standard target at one to reach them there. A skill already in one of those directories that to11 did not write is left alone and reported. Only an explicit to11 skill sync --force replaces one that a published skill needs the name of.
Staying current without asking
The to11 plugin, whichto11 offers to install for Claude Code and Codex when it links a location, refreshes skills while a session is open — when it starts, when you submit a prompt, and in Claude Code before a skill is used. A refresh inside the cache window (60 seconds by default) makes no request, and a refresh never blocks the work that triggered it. to11 skill sync refreshes on demand.
Where to read them
Skills are written as folders and stored from the to11 CLI. The dashboard lists them beside your chat prompts, shows each file as a machine receives it, and compares versions. It does not edit them — a skill’s source of truth is its folder. What a skill is explains why, and what a skill can and cannot carry. Skills use the same permissions as prompts; there is no separate set. See Roles & permissions.Next steps
Quickstart
Receive a skill and publish your own — in one pass.
What a skill is
The folder format, its limits, and what a skill cannot carry.
Receiving skills
Install the CLI and configure a machine or a repository.
Publishing skills
Store a version from a folder; everyone who follows the project receives it.