# ensskills

Versioned agent skills for ENS — teach AI coding agents (Claude Code, Cursor, Codex, …) the ENS Omnigraph.

`ensskills` ships `SKILL.md` bundles under `skills/`. Install them one of two ways — both **pin to an exact version**, never a moving `main`, so skills stay in lockstep with your ENSNode suite.

### In an npm project — `skills-npm`

[`skills-npm`](https://github.com/antfu/skills-npm) symlinks the pinned package into your agent directories:

```jsonc
// package.json
{
  "devDependencies": {
    "ensskills": "1.15.1",
    "skills-npm": "^1",
  },
  "scripts": {
    "prepare": "skills-npm",
  },
}
```

```bash
npm install   # symlinks the skills for your detected agents
```

### Without npm — Vercel's `skills` CLI

Not in a Node project? [`skills`](https://github.com/vercel-labs/skills) installs straight from this repo. Point it at the `packages/ensskills/skills` directory on the matching **release tag** (the `v` prefix is how you pin without npm):

```bash
# install every ENS skill, pinned to the matching release
npx skills add https://github.com/namehash/ensnode/tree/v1.15.1/packages/ensskills/skills --skill '*'

# or list them first, then pick the ones you want
npx skills add https://github.com/namehash/ensnode/tree/v1.15.1/packages/ensskills/skills --list
npx skills add https://github.com/namehash/ensnode/tree/v1.15.1/packages/ensskills/skills --skill omnigraph
```

The skills drive [`enscli`](https://www.npmjs.com/package/enscli) for live lookups. The `omnigraph` skill's schema reference and example queries are autogenerated via `pnpm -F ensskills generate`.

See the [ensskills documentation](https://ensnode.io/docs/integrate/integration-options/ensskills) for details.

## License

Licensed under the MIT License, Copyright © 2025-present [NameHash Labs](https://namehashlabs.org).

See [LICENSE](./LICENSE) for more information.