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

# Comet: agent Skill harness automation from idea to archive

> Comet provides a CLI, Skill composition, Skill evaluation, and a classic Spec workflow that routes /comet requests from idea to archive.

Welcome to **Comet** (`@rpamis/comet`). This section covers classic Spec mode. Comet connects [OpenSpec](https://github.com/Fission-AI/OpenSpec) and [Superpowers](https://github.com/obra/superpowers) into a five-phase workflow, then adds CodeGraph-assisted context retrieval so long-running coding work uses fewer tokens.

You do not need to remember the original OpenSpec or Superpowers Skill commands. Use `/comet`, and Comet routes the request through proposal, design, implementation, verification, and archive. It detects the current phase from files, so you can resume after interruptions.

<CardGroup cols={2}>
  <Card title="Introduction" icon="star" href="/en/introduction">
    Understand what Comet is, what it solves, and how the workflow operates.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/en/quickstart">
    Install Comet and run your first recoverable `/comet` workflow.
  </Card>

  <Card title="Workflow" icon="arrows-rotate" href="/en/concepts/workflow">
    Learn the five phases: open, design, build, verify, and archive.
  </Card>

  <Card title="Platforms" icon="laptop-code" href="/en/platforms">
    See the 33 supported AI coding platforms and their install capabilities.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/en/cli/quickstart">
    Use the Comet CLI for installation, status, diagnostics, Skill work, evals, and publishing.
  </Card>

  <Card title="Core scripts" icon="scroll" href="/en/scripts/overview">
    Understand the Node launchers behind state, guards, handoff, archive, and routing.
  </Card>

  <Card title="Compose any Skill" icon="blackberry" href="/en/skill-creator/getting-started">
    Use `/comet-any` to compose arbitrary Skills into evaluable, publishable Skill bundles.
  </Card>

  <Card title="Evaluate any Skill" icon="vial-circle-check" href="/en/eval/quickstart">
    Score Skills with rubrics, pass\@k, pass^k, HTML reports, and failure attribution.
  </Card>
</CardGroup>

## Get started in three steps

<Steps>
  <Step title="Install the Comet CLI globally">
    Install from npm so the `comet` command is available on your machine.

    ```bash theme={null}
    npm install -g @rpamis/comet
    ```
  </Step>

  <Step title="Run comet init in your project">
    Go to the project root and initialize Comet. The wizard lets you choose project or global install scope, preferred Skill language, and target AI platforms.

    ```bash theme={null}
    cd your-project
    comet init
    ```
  </Step>

  <Step title="Call /comet from your AI coding tool">
    Open Claude Code, Codex, Cursor, or another [supported platform](/en/platforms), then type `/comet`. Comet reads project state, detects the phase, uses intent routing, and continues the workflow.

    ```bash theme={null}
    /comet what you want to build
    ```
  </Step>
</Steps>

## AI-native docs

You can connect the Comet docs site to your agent through MCP, so your assistant can retrieve up-to-date docs during conversations.

### Use with Claude Code

```bash theme={null}
claude mcp add --transport http docs-comet --scope user https://docs.comet.rpamis.com/mcp
```

### Use with Codex CLI

```bash theme={null}
codex mcp add docs-comet --url https://docs.comet.rpamis.com/mcp
```

### Use with Cursor/Antigravity

```json theme={null}
{
  "mcpServers": {
    "docs-comet": {
      "url": "https://docs.comet.rpamis.com/mcp"
    }
  }
}
```

### Use with VS Code

```json theme={null}
{
  "servers": {
    "docs-comet": {
          "url": "https://docs.comet.rpamis.com/mcp"
    }
  }
}
```