For AIs to read
Skills
What the System of Reason skills do, and the one way to add XOR and the skills in each app.
The skills teach an app to save and find your notes the same way every other app does. There are three:
| Skill | What it does |
|---|---|
system-of-reason-memory |
Saves a note when you ask it to remember something, finds notes when you ask what was decided, and corrects or forgets a note when you ask. |
system-of-reason-wrap-up |
Saves where a piece of work stands when you ask for a wrap-up, and reads it back when you ask to pick up where you left off. |
system-of-reason-get-started |
Shows what your account keeps, and how to save and reuse it from any connected app. |
They act when you ask. An app may offer once to save a decision or a wrap-up, and it saves only if you say yes.
If you’d rather not follow the steps yourself, paste the prompt on Get started into your app. It reads the setup guide and does the one install for the app you’re in. The blocks below are that same install.
Do one block. Don’t connect the server by hand and also install the plugin.
Claude Code
In a terminal, not as a slash command inside a chat (inside a chat, /plugin install only opens a panel):
claude plugin marketplace add rblalock/system-of-reason-plugin
claude plugin install system-of-reason@system-of-reason
That connects XOR and adds the skills. In Claude Code, type /mcp, pick system-of-reason, and sign in with your email and the code we send.
Don’t also run claude mcp add.
If XOR is already there because you added it on claude.ai, stop. Don’t install the plugin on top of it. To add only the skills:
npx skills add rblalock/system-of-reason-plugin -s '*'
More on the Claude Code page, including a machine with no browser.
Codex
In a terminal:
codex plugin marketplace add rblalock/system-of-reason-plugin
codex plugin add system-of-reason@system-of-reason
That connects XOR and adds the skills. Codex opens a browser so you can sign in. If it doesn’t, run codex mcp login system-of-reason.
Don’t also run codex mcp add. More on the Codex page.
Cursor
- Clone https://github.com/rblalock/system-of-reason-plugin. The repository includes
.cursor-plugin/plugin.json. - In Customize, choose Add Marketplace, then Import from Disk.
- Install System of Reason.
If you cannot clone, send this in Cursor’s chat instead. That command can stay on the first commit it fetched.
/add-plugin https://github.com/rblalock/system-of-reason-plugin
Do not choose Import from GitHub. A personal marketplace added that way is not indexed, so no plugin appears. Sign in when Cursor asks.
If XOR’s tools do not appear after that, add the server and the skills yourself, once. Don’t do this when the tools are already there. Open ~/.cursor/mcp.json and add:
{
"mcpServers": {
"xor": { "url": "https://systemofreason.com/mcp" }
}
}
Then, in a terminal:
npx skills add rblalock/system-of-reason-plugin -s '*'
More on the Cursor page.
Claude
Claude on the web and in the desktop app doesn’t install this plugin. Add the connector on the Claude page. That is the connection.
To add the skills, download rblalock/system-of-reason-plugin, zip each folder in skills/ (the folder itself, not only its files), and upload each ZIP under Customize, then Skills. Or just ask: “Remember this in XOR.”
ChatGPT
ChatGPT doesn’t install these skills. Add the connector on the ChatGPT page, then ask in plain words: “Remember this in XOR.”
Other apps
Connect the server and, when the app can read skills, add them. The server:
https://systemofreason.com/mcp
Call it XOR. Sign in with your email and the code we send. Steps for Grok, OpenCode, VS Code and the rest are on Other apps.
Skills, in a terminal, for an app that reads them:
npx skills add rblalock/system-of-reason-plugin -s '*'
-s '*' installs all three. Add -g for every project. Don’t use --all. This command copies the skills only. If the app isn’t connected yet, connect the server too. Don’t do it when a plugin install already did both.
A chat app that can’t install skills still works. Ask: “Remember this in XOR.”
Where notes go
A note is a row in the notes table of the default database in the project memory. The first note makes the table. The columns, including topic, are in the setup guide. You can see notes in your account.