> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install guides

> Drop your xysq Skill into any agent — Claude, Cursor, Windsurf, Codex, Gemini, Antigravity, Copilot.

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](/features/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](https://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:

```bash theme={"dark"}
# 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](/integrations/connect-agent).

**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.

<video src="https://storage.googleapis.com/xysq_public/skill%20demo%20xysq.mp4" controls style={{ width: "100%", borderRadius: "8px", marginBottom: "1rem" }} />

## Claude.ai (web)

The web app doesn't expose a standalone Skills feature, but Project Instructions work identically. Connect xysq via the [Claude integration](/integrations/connect-agent) first.

1. Open or create a **Project** at [claude.ai](https://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](/integrations/connect-agent).

```bash theme={"dark"}
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](/integrations/connect-agent).

```bash theme={"dark"}
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](/integrations/connect-agent).

**Project scope:**

```bash theme={"dark"}
mv ~/Downloads/xysq.md ./AGENTS.md
```

If `AGENTS.md` already exists, append rather than overwrite:

```bash theme={"dark"}
cat ~/Downloads/xysq.md >> ./AGENTS.md
```

**Global scope (every Codex session on this machine):**

```bash theme={"dark"}
mkdir -p ~/.codex
mv ~/Downloads/xysq.md ~/.codex/AGENTS.md
```

## Gemini CLI

Adapter via `GEMINI.md`. Connect xysq first via the [Gemini CLI integration](/integrations/connect-agent).

**Project scope:**

```bash theme={"dark"}
mv ~/Downloads/xysq.md ./GEMINI.md
```

**Global scope:**

```bash theme={"dark"}
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](/integrations/connect-agent).

Open **Antigravity → Settings → Agent rules** (or **Agent instructions**) and paste the entire contents of your `xysq.md` file. Save.

For project-scoped rules:

```bash theme={"dark"}
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:

```bash theme={"dark"}
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.

## Related

* [Standard skill](/features/skills) - what the skill instructs and how to download it
* [Connect your agent](/integrations/connect-agent) - MCP setup guides per agent