# indexer

Sets up an Envio HyperIndex indexer that captures Monad smart contract events and exposes them over GraphQL for activity feeds or app triggers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 248 installs · ★ 15 repo stars
- Author: therealharpaljadeja
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/therealharpaljadeja/monskills/tree/HEAD/skills/indexer/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/indexer

## What it does

The skill runs `envio init contract-import explorer` inside an `indexer/` folder, passing the contract address, network (`monad` or `monad-testnet`) and TypeScript as the target language. The contract has to be deployed and verified on a Monad explorer first, since ABI import pulls from there and fails on unverified contracts. Init produces `config.yaml`, `schema.graphql` and handler stubs that the developer fills in to decide what gets stored.

Transaction fields like `event.transaction.hash` are typed `never` by default, so handlers need a `field_selection` block added to `config.yaml` and a `pnpm codegen` rerun before those fields become usable.

Deploying and managing the indexer on Envio Cloud requires `envio-cloud` and the GitHub CLI (`gh`) already installed and authenticated. The skill won't install or log either in on its own, and a monskills hook blocks the command with a pointer to whatever's missing.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add therealharpaljadeja/monskills --skill indexer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/indexer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/indexer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add therealharpaljadeja/monskills --skill indexer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/indexer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add therealharpaljadeja/monskills --skill indexer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/indexer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install therealharpaljadeja/monskills skills/indexer
```

2. **Manually: put the files in place**
- File: `.github/skills/indexer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add therealharpaljadeja/monskills --skill indexer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/therealharpaljadeja/monskills --path skills/indexer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/indexer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add therealharpaljadeja/monskills --skill indexer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/therealharpaljadeja/monskills/tree/HEAD/skills/indexer/SKILL.md

## When to use it
- build a historical feed of contract events
- trigger an app action from an onchain event
- get a GraphQL endpoint for a deployed indexer
- debug an indexer that fails to deploy or sync
- restart, promote or delete an existing Envio Cloud deployment

## Example prompts
- Initialize an indexer for the MyToken contract on Monad testnet
- Add transaction_fields with hash to config.yaml and regenerate types
- Help debug an indexer that's failing to sync on Envio Cloud

## Similar
- [subgraph-migrate](https://affpapa.org/en/nevibecode/skills/subgraph-migrate.md) — skill · 5000 installs
- [accessing-data](https://affpapa.org/en/nevibecode/skills/accessing-data.md) — skill · 491 installs
- [Ayni](https://affpapa.org/en/nevibecode/mcp/ayni.md) — MCP server · 3320 installs
- [Panal](https://affpapa.org/en/nevibecode/mcp/panal.md) — MCP server · ★ 6 repo stars
- [nuthatch](https://affpapa.org/en/nevibecode/mcp/nuthatch.md) — MCP server · ★ 8 repo stars
- [azure-video-indexer](https://affpapa.org/en/nevibecode/skills/azure-video-indexer.md) — skill · 166 installs

From the same set: [therealharpaljadeja/monskills](https://affpapa.org/en/nevibecode/by/therealharpaljadeja/monskills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
