Contexory for Claude Code
Keep Claude Code in sync with the skills your team manages in Contexory, and let it create, edit, and publish those skills on request.
Install
Install from the Claude Code marketplace. In Claude Code, add the Contexory marketplace, then install the plugin:
/plugin marketplace add https://www.contexory.com/claude/marketplace.json
/plugin install contexory@contexoryThat is everything you need to start syncing. Connecting your account is the one remaining step.
Connect your account
Paste an API token to link this machine to your Contexory workspace.
- 1
Generate an API token
In the Contexory web app, open Settings → API tokens, generate a token, and copy it. It's shown once, so store it somewhere safe. The token is pinned to your currently active workspace.
- 2
Paste it into the plugin config
When you enable the Contexory plugin, Claude Code prompts for the API token — paste it there (it's stored securely, not in plaintext). Already enabled? Update the token in the plugin's config and run
/reload-plugins. No terminal or browser required, so it works over SSH and on headless machines. - 3
Target a different workspace
A token only ever acts on the workspace that was active when you generated it. To sync a different workspace, switch to it in the web app, generate a new token, and paste that one in.
Revoking
Revoke a token any time from the Contexory web app under Settings → API tokens — the plugin loses access immediately.Verify
Confirm the connection with /contexory:test. Your published skills start syncing right away and appear to Claude as contexory:<name>, refreshing on their own as new versions ship.
Commands
Run these from a Claude Code conversation. /contexory:mode and /contexory:reviewers print the current value when called with no argument; pass a value to change it, which takes effect on your next publish with no reload.
| Command | What it does |
|---|---|
/contexory:status | List synced skills and flag local edits. |
/contexory:sync | Pull the latest published skills now. |
/contexory:test | Verify the connection works. |
/contexory:mode [auto-publish | require-review] | Show or change how publishing behaves. |
/contexory:reviewers [uuid,…] | Show or change the default reviewers for opened reviews. |
Settings
Configure defaults in the plugin's settings. /contexory:mode and /contexory:reviewers override the mode and reviewers per machine without leaving the conversation; the settings below act as the fallback when no override is set.
| Setting | Accepted values | Default | What it controls |
|---|---|---|---|
| Enable management tools | true / false | false | Lets Claude create, edit, delete, and publish skills in your workspace (your token must be write-scoped). Read-only when false. After changing it, run /reload-plugins. |
| Publish mode | require-review / auto-publish | require-review | require-review opens a review for human approval in the web app; auto-publish ships changes immediately. Also settable with /contexory:mode. |
| Default reviewers | Comma-separated user UUIDs | "" (none) | Reviewers attached to opened reviews when publish mode is require-review. Also settable with /contexory:reviewers. |
| Background sync interval | Whole number of minutes | 5 | How often the plugin checks Contexory for newly published skills. |
Reload after enabling management
The tool list is fixed when the plugin starts. Run/reload-plugins after turning management on so Claude picks up the write tools (your API token must be write-scoped).Skill tools
Once connected, Claude can read and sync your skills. The write tools stay hidden until you enable management.
- Read (always available): list your skills, fetch a skill's draft, and confirm a local folder is Contexory-managed.
- Write (when management is on): create, update, delete, write a file inside a skill, and publish, following your publish mode.
Where things live
| What | Location |
|---|---|
| Synced skills | Owned by the plugin and surfaced as contexory:<name>. The path is fixed so it never collides with your personal ~/.claude/skills folders. |
| API token | Stored securely by Claude Code (system keychain), never in plaintext on disk. |
| Per-machine overrides | ~/.contexory/settings.json |
Privacy and access
The plugin only talks to the Contexory API on your behalf, using the API token you provide. Read-only sync needs no special permission, and management tools stay hidden until you explicitly enable them. The token is stored securely on your machine and never leaves it except to authenticate with Contexory. Learn more on the security page.