# Platform Distribution & Skills Publication Guide

**Organization:** [VorteXpert Labs](https://github.com/vortexpert-labs) | **Author:** [Sabber Ahamad Emon](https://github.com/sabber-ahamad-emon)

This guide explains how to install, use, and publish the **Anchor Protocol Skill** across all major AI agent platforms and registries.

---

## 1. Universal GitHub URL Auto-Install (Zero Configuration)

Users can give their AI coding agent the repository link:

> *"Integrate Anchor Protocol from https://github.com/vortexpert-labs/anchor-protocol"*

Any modern AI coding agent (Claude Code, Gemini CLI, Cursor Composer, Windsurf Cascade, Copilot, Cline, Roo Code, Aider, OpenHands) will automatically:
1. Fetch and read `SKILL.md`.
2. Initialize `.anchors/` with `schema.json` and `INDEX.md`.
3. Inject the appropriate non-destructive tool adapter into the repository.

---

## 2. Platform-Specific Installation & Publication

### A. Anthropic Claude Code
- **Repository Level:** The repository includes `CLAUDE.md`. Claude Code reads this upon session startup.
- **Global Skill Installation:**
  ```bash
  mkdir -p ~/.claude/skills/anchor-protocol
  cp SKILL.md ~/.claude/skills/anchor-protocol/SKILL.md
  ```
- **Usage in Claude Code:** Run `/anchor-protocol` or ask Claude to check project orientation.

### B. Google Gemini CLI / Antigravity (AGY)
- **Repository Level:** Antigravity reads `AGENTS.md` and `GEMINI.md` hierarchically.
- **Workspace Skill:**
  ```bash
  mkdir -p .agents/skills/anchor-protocol
  cp SKILL.md .agents/skills/anchor-protocol/SKILL.md
  ```
- **Global Machine Installation:**
  ```bash
  mkdir -p ~/.gemini/config/skills/anchor-protocol
  cp SKILL.md ~/.gemini/config/skills/anchor-protocol/SKILL.md
  ```

### C. Cursor IDE (`.cursor/rules/*.mdc`)
- **MDC Rules:** Cursor automatically detects `.cursor/rules/anchor-protocol.mdc`.
- **Note:** The legacy `.cursorrules` root file is deprecated. Use `.cursor/rules/` directory with MDC format.
- **Publication to Cursor Directory (`cursor.directory`):**
  - Submit `.cursor/rules/anchor-protocol.mdc` to [cursor.directory](https://cursor.directory) under the **Architecture & Systems** category.

### D. GitHub Copilot
- **Repository Instructions:** Stored at `.github/copilot-instructions.md`.
- **Copilot Workspace / PR Reviews:** Automatically verified on all pull requests.

### E. Windsurf (Codeium)
- **Directory Rules:** Stored at `.windsurf/rules/anchor-protocol.md` (supports semantic XML tags).
- **Single-File Fallback:** Stored at `.windsurfrules`.
- **Cascade Memories:** Cascade reads `.anchors/INDEX.md` as permanent project memory.

### F. Cline & Roo Code
- **Configuration:** Stored at `.clinerules`.
- **Custom Mode:** Configurable in `.roomodes` as an "Architect Mode" prompt.

### G. Amazon Q Developer
- **Workspace Rules:** Stored at `.amazonq/rules/anchor-protocol.md`.

### H. JetBrains Junie
- **Guidelines:** Stored at `.junie/guidelines.md`.

### I. Zed Editor
- **Discovery:** Automatically reads `AGENTS.md` and `CLAUDE.md`.

### J. Aider
- Add `.anchors/INDEX.md` to `.aider.conf.yml`:
  ```yaml
  read:
    - .anchors/INDEX.md
  ```

### K. Universal npm Scaffolding (npx)
- **Instant Global Execution (No install required):**
  ```bash
  npx @vortexpert-labs/anchor-protocol init --stage PROTOTYPE
  npx @vortexpert-labs/anchor-protocol check --strict
  ```
- **Global Package Install:**
  ```bash
  npm install -g @vortexpert-labs/anchor-protocol
  anchor check --strict
  ```