Use case · Skills

Our best agent skills live on one laptop. Give each engineer the same catalog on every machine.

Keep your team's skills in one GitHub repo. Each engineer imports it once, and the skill that matches loads on every machine they use. Import again to update.

Pick a moment

The team's best skills sit in one home folder.

Built into each agent

  • SKILL.md files on each machine or repo
  • Copied by commit, plugin or admin folder
  • A folder for each agent

One catalog on your account

  • Imported from your team's GitHub repo
  • One catalog for both agents
  • Nothing written to the disk

Each machine or repo needs its own copy. Context Mode keeps the skills on the gateway.

Put the skills in a GitHub repo. Import it once.

// console → Skills
https://github.com/your-org/agent-skills
→ Preview import
→ Add all

Large repos import in batches. Import again to update.

A teammate imports the same repo on their account.

// their console → Skills
https://github.com/your-org/agent-skills
→ Preview import → Add all
Their skillsdiagnosing-bugsto-ticketsbatch-grill-me

Same repo, same skills. When the repo changes, each of you imports again.

“Since this morning our blog URLs end with a dash. … the test suite is red. … Figure out what broke and fix it.”

Your skillsdiagnosing-bugsto-ticketsbatch-grill-me
⏺ context-mode · skill diagnosing-bugs auto-loaded

Nobody typed a skill name. The reply names the skill that loaded.

“Walk me through how slugify turns a title into a slug, step by step.”

Your skillsdiagnosing-bugsto-ticketsbatch-grill-me

This question matches no skill, so none loads. If the match is weak, no skill loads.

Right skill picks on 10 texts, offline.

Before4 of 10
Now, short list9 of 10
Now, all skills10 of 10

Small sample, judged by one person. Treat it as direction.

The problem

One engineer wrote the skills. The rest of the team never gets them.

Skills are files on each disk

The agent loads skills from SKILL.md files. Each machine or repo needs its own copy, by commit, plugin or admin folder.

Each agent has its own folder

Claude Code and Codex read skills from different folders. A team that uses both keeps a copy for each.

The model picks on its own

In each agent, the model loads a skill when its description fits, using only the files on that machine.

How it works

From a repo to every agent. No files to sync.

  1. 01Put the skills in a GitHub repo

    One folder per skill, each with a SKILL.md and a clear description.

  2. 02Each engineer imports it once

    In the console, open Skills, paste the repo URL, click Preview import, then Add all. The catalog is one per account, and there are no team roles yet, so each engineer imports the same repo. Import again to update. A skill body can be 262,144 bytes at most.

  3. 03The right skill loads

    On every machine you use, Context Mode compares each message with each skill. At most one loads per turn, and the reply names it.

Agents on any laptop send each message through Context Mode. It holds the skill catalog imported from GitHub, picks the one skill that matches, or none, and adds it to the request. Then the request goes to the model. Agent, laptop A Agent, laptop B Agent, a new laptop Context Mode skill catalog, from GitHub pick one skill, or none add it to the request name it in the reply The model your own account
Agents on any laptop send each message through Context Mode. It holds the catalog imported from GitHub, picks one skill or none, adds it to the request and names it in the reply. Then the request goes to the model on your own account. Nothing is written to the disk.
Proof

The right skill, or none. Named in every reply.

10 of 10right skill picks on a small offline test, against 4 of 10 with the old judge
About 760tokens a request for the skill list in our benchmark accounts, read from cache
Context ModeBuilt into each agent
Where skills liveOne catalog on your accountFiles on each machine or repo
New laptopReady at once on your account; each teammate imports the repo onceCommit, plugin or admin folder on each machine
Claude Code and CodexOne catalog for bothA folder for each agent
Which skill loadsThe one that matches, named in the replyThe agent decides

Skill picks: an offline eval on 10 texts, judged by one person. Treat the numbers as direction, not as live accuracy. We have not measured whether skills give better answers. The catalog is one per account; there are no team roles yet, so each engineer imports the same repo, and imports again after a change. Method and sources →

Products used

What this uses.

Skills

Import from GitHub once per account. The skill that matches loads, one per turn at most.

Skills docs

Import, matching, the reply line, cost, and a 5-minute test.

How a skill is picked

The judge, the 0.5 floor, and what we have not measured.

Related

Team standards · For platform teams · Instructions

Write a skill once. Every teammate uses it.

npx @context-mode/cli connects your agents. 1,000 requests free, no card.

Get started free

Your coding agent costs less and remembers your project.

Start free: 1,000 requests, every feature, no card. After you sign in, the console gives you one command to connect Claude Code or Codex.

Read the docs