# indexion-skills

Claude Code plugin providing skills powered by [indexion](https://github.com/trkbt10/indexion) — source code exploration, similarity analysis, and documentation tools.

## Installation

```bash
# Add marketplace and install
claude marketplace add trkbt10/indexion-skills
claude plugin install indexion-skills
```

## Prerequisites

indexion must be installed and available in your PATH:

```bash
curl -fsSL https://raw.githubusercontent.com/trkbt10/indexion/main/install.sh | bash
```

Some skills require newer commands than an older installed binary may provide.
For agent orientation, verify:

```bash
indexion agent orient --help
```

## Available Skills

### Agent Orientation

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-agent-orient` | `indexion agent orient` | Generate a pre-edit structure brief from a cached orientation map so zero-knowledge agents can infer likely owners, consumer surfaces, and unsafe edit locations before coding |

### Exploration & Analysis

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-search` | `indexion grep`, `indexion search`, `indexion explore` | Choose the right search mode for structural, lexical, semantic, or similarity questions |
| `indexion-segment` | `indexion segment` | Split text into contextual segments |
| `indexion-kgf` | `indexion kgf` | Inspect and debug KGF language specs |

### Identity & Naming

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-identity` | `indexion identity audit` | Detect drift between file, folder, symbol names, and implementation contents, then classify rename, move, split, hollow, or keep actions |

### Documentation & README

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-documentation` | `indexion plan documentation/reconcile`, `indexion doc graph` | Documentation analysis — coverage, drift detection, dependency graphs |
| `indexion-readme` | `indexion doc init/readme`, `indexion plan readme` | README construction — initialize, generate, plan, assemble |
| `indexion-wiki` | `indexion wiki *` | Maintain project wiki pages, indexes, linting, source logs, and code-to-doc drift checks |

### Spec-Driven Development

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-sdd` | `indexion spec *` | SDD validation loop: draft, verify, align, validate with cc-sdd/codex |

### Planning

| Skill | Command | Description |
|-------|---------|-------------|
| `indexion-refactor` | `indexion plan refactor`, `indexion plan solid` | Detect duplication, wrapper bloat, shared-code extraction opportunities, and concept-level SoT violations |

## Plugin Structure

```
indexion-skills/
├── .claude-plugin/
│   ├── plugin.json          # Plugin manifest
│   └── marketplace.json     # Marketplace registry
├── skills/
│   ├── indexion-agent-orient/ # Agent preflight orientation
│   ├── indexion-search/      # Structural, lexical, semantic, and similarity search
│   ├── indexion-identity/    # Name/content drift audit
│   ├── indexion-segment/     # Text segmentation
│   ├── indexion-kgf/         # KGF spec inspection
│   ├── indexion-documentation/ # Documentation analysis (coverage, reconcile, graph)
│   ├── indexion-readme/       # README construction (init, generate, assemble)
│   ├── indexion-wiki/        # Wiki lifecycle
│   ├── indexion-sdd/         # Spec-Driven Development loop
│   ├── indexion-refactor/    # Refactor planning and validation
└── LICENSE
```

## License

Apache-2.0