Skip to main content
Pick your agent. Each section tells you which file to download from the dashboard and where to put it. Only Claude products consume Anthropic’s Agent Skills format natively. For other agents, xysq emits the same content in the rules-file or system-prompt format that tool expects — the instructions are identical, only the wrapper differs. Once installed, verify by sending a substantive first message. The agent should call memory_recall(query=<your message>, budget="low") to pull relevant context before answering. authenticate() runs lazily on the first write, not at session start. memory_reflect is reserved for synthesis questions (“what do I prefer about X”).

​
Claude Code

The recommended path is the xysq plugin: one install wires the MCP connection, the standard skill, and all five recall skills (recap, decisions, actionables, blockers, prep). 
/plugin marketplace add xysq-ai/xysq-claude-plugin
/plugin install xysq
If it isn’t picked up automatically, run /reload-plugins. Then authenticate once with /mcp - select xysq and approve the OAuth sign-in (stored in your keychain). Organisation accounts paste the org_path from app.xysq.ai/connect-agent when the install prompts for it; personal accounts leave it empty. Update later with /plugin update xysq. Verify with /skills - you should see xysq plus recap, decisions, actionables, blockers, and prep. Manual alternative (standard skill only, no plugin): if you’d rather drop the skill file in yourself, download xysq.md from the dashboard and place it: 
# user scope (all projects)
mkdir -p ~/.claude/skills/xysq && mv ~/Downloads/xysq.md ~/.claude/skills/xysq/SKILL.md
# or project scope (committed to a repo)
mkdir -p .claude/skills/xysq && mv ~/Downloads/xysq.md .claude/skills/xysq/SKILL.md
This gives you only the standard skill (not the recall skills or the MCP server). Updates: re-download and overwrite SKILL.md. Claude Code reloads skills at session start.

​
Claude Desktop

Native Skills feature. Connect xysq first via the Claude integration. Option A — Global Skill (recommended): Open Settings → Skills → Add Skill, select your xysq.md, toggle it on. Applies to every conversation. Option B — Project Instructions: Open a project → Project Instructions → paste the contents of xysq.md. Only conversations in that project pick it up.

​
Claude.ai (web)

The web app doesn’t expose a standalone Skills feature, but Project Instructions work identically. Connect xysq via the Claude integration first.
  1. Open or create a Project at claude.ai
  2. Click Set custom instructions
  3. Paste the contents of xysq.md and save
Conversations outside a Project won’t have the skill — always start chats inside the Project.

​
Cursor

Adapter via .cursorrules. Connect xysq first via the Cursor integration. 
mv ~/Downloads/.cursorrules ./.cursorrules
Cursor picks up .cursorrules automatically — no restart. For a global rule across every project, use Cursor → Settings → Rules for AI and paste the contents there. Commit .cursorrules to your repo so collaborators get the same xysq-aware behaviour.

​
Windsurf

Adapter via .windsurfrules. Connect xysq first via the Windsurf integration. 
mv ~/Downloads/.windsurfrules ./.windsurfrules
For a global rule: Windsurf → Settings → Cascade → Global rules and paste the contents there.

​
Codex CLI

Adapter via AGENTS.md. Connect xysq first via the Codex CLI integration. Project scope: 
mv ~/Downloads/xysq.md ./AGENTS.md
If AGENTS.md already exists, append rather than overwrite: 
cat ~/Downloads/xysq.md >> ./AGENTS.md
Global scope (every Codex session on this machine): 
mkdir -p ~/.codex
mv ~/Downloads/xysq.md ~/.codex/AGENTS.md

​
Gemini CLI

Adapter via GEMINI.md. Connect xysq first via the Gemini CLI integration. Project scope: 
mv ~/Downloads/xysq.md ./GEMINI.md
Global scope: 
mkdir -p ~/.gemini
mv ~/Downloads/xysq.md ~/.gemini/GEMINI.md
If GEMINI.md already exists, append rather than overwrite.

​
Antigravity

Adapter via agent rules. Connect xysq first via the Antigravity integration. Open Antigravity → Settings → Agent rules (or Agent instructions) and paste the entire contents of your xysq.md file. Save. For project-scoped rules: 
mkdir -p .gemini
mv ~/Downloads/xysq.md .gemini/AGENTS.md

​
GitHub Copilot CLI

Adapter via system prompt. MCP support on Copilot CLI is inconsistent across versions — without it, the skill works for stated preferences but capture and recall tools won’t function. Copilot CLI’s system-prompt location depends on your version. Check gh copilot config for the current path. As a pattern: 
mkdir -p ~/.config/gh-copilot
mv ~/Downloads/xysq.md ~/.config/gh-copilot/system-prompt.md
Then point Copilot CLI at that file via its config (see gh copilot config --help).

​
Updating

When the dashboard shows a new skill version, re-download and overwrite the file at the same path. The agent reloads at the start of its next session. For Claude Desktop with Option A (Skills feature), replace the file in Settings → Skills. For pasted instructions, paste the new contents over the old.