-
Notifications
You must be signed in to change notification settings - Fork 16
docs: enscli and ensskills docs
#2112
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
40 changes: 40 additions & 0 deletions
40
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enscli.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,40 @@ | ||
| --- | ||
| title: enscli | ||
| description: Coming soon — an agent- and human-friendly CLI for the ENS Omnigraph API, wrapping enssdk. | ||
| --- | ||
|
|
||
| import { Aside, LinkCard } from "@astrojs/starlight/components"; | ||
|
|
||
| <Aside type="caution" title="Coming soon"> | ||
| **`enscli`** is a planned ENS CLI that wraps [`enssdk`](/docs/integrate/integration-options/enssdk) to bring the ENS Omnigraph to the terminal. The npm name is reserved; we're still shaping the design. `enscli` will ship soon. | ||
| </Aside> | ||
|
|
||
| `enscli` will be the terminal-shaped entry point to the [ENS Omnigraph](/docs/integrate/omnigraph) — a single CLI for resolving names, looking up records, searching domains, and running ad-hoc queries against any ENSNode instance. | ||
|
|
||
| Designed to feel natural whether you're driving it yourself or letting an AI agent drive. From a terminal it's one `npx` away with sensible defaults against the public Omnigraph; for agents it's predictable arguments, structured output, and machine-readable help. | ||
|
|
||
| ## Built for | ||
|
|
||
| - Developers exploring or validating an ENS integration from a terminal, without writing a script first. | ||
| - Operators wiring ENS lookups into shell pipelines, cron, or CI. | ||
| - AI coding agents driving [`ensskills`](/docs/integrate/integration-options/ensskills), which reach into the protocol through `enscli`. | ||
|
|
||
| ## Related | ||
|
|
||
| <LinkCard | ||
|
Goader marked this conversation as resolved.
|
||
| title="enssdk" | ||
| description="The TypeScript SDK that enscli wraps." | ||
| href="/docs/integrate/integration-options/enssdk" | ||
| /> | ||
|
|
||
| <LinkCard | ||
| title="ensskills" | ||
| description="The agent-skill bundles that drive enscli on a developer's behalf." | ||
| href="/docs/integrate/integration-options/ensskills" | ||
| /> | ||
|
|
||
| <LinkCard | ||
| title="ENS Omnigraph API" | ||
| description="The underlying GraphQL API enscli speaks to." | ||
| href="/docs/integrate/omnigraph" | ||
| /> | ||
46 changes: 46 additions & 0 deletions
46
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/ensskills.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| --- | ||
| title: ensskills | ||
| description: Coming soon — skill bundles that give AI agents an opinionated contract for ENS. | ||
| --- | ||
|
|
||
| import { Aside, LinkCard } from "@astrojs/starlight/components"; | ||
|
|
||
| <Aside type="caution" title="Coming soon"> | ||
| **`ensskills`** is a planned collection of agent skills for ENS development and ENS lookups. The npm name is reserved; we're still shaping the design. `ensskills` will ship soon. | ||
| </Aside> | ||
|
|
||
| `ensskills` will be a small, curated set of skills that give AI coding agents — Claude Code, Cursor, Codex, and the rest — a well-defined contract for working with ENS. We want to support users who want a conversational interaction with ENS through their AI assistant, handled by skills that drive [`enscli`](/docs/integrate/integration-options/enscli) behind the scenes, and to streamline the developer experience writing integration code with [`enssdk`](/docs/integrate/integration-options/enssdk), [`enskit`](/docs/integrate/integration-options/enskit), or the raw [Omnigraph API](/docs/integrate/omnigraph). | ||
|
|
||
| Left to their own devices, agents love to reinvent the wheel from scratch every prompt — burning through your token budget rediscovering what ENS even is before they get around to the actual task. `ensskills` will be blueprints: focused, versioned bundles that hand the agent the right context for ENS work — no more, no less. The result is agents that produce ENS code that actually works, without the developer having to brief them from scratch every time. | ||
|
|
||
| ## Built for | ||
|
|
||
| - Developers building ENS apps with AI agents in the loop. | ||
| - End-users asking AI assistants ENS-shaped questions and expecting answers grounded in the protocol. | ||
| - Teams moving from the legacy ENS Subgraph onto the Omnigraph. | ||
|
|
||
| ## Related | ||
|
|
||
| <LinkCard | ||
| title="enscli" | ||
| description="The CLI ensskills drives at runtime for ENS state lookups." | ||
| href="/docs/integrate/integration-options/enscli" | ||
| /> | ||
|
|
||
| <LinkCard | ||
| title="enssdk" | ||
| description="The TypeScript SDK ensskills teaches agents to author code against." | ||
| href="/docs/integrate/integration-options/enssdk" | ||
| /> | ||
|
|
||
| <LinkCard | ||
| title="enskit" | ||
| description="The React toolkit ensskills steers agents toward for UI work." | ||
| href="/docs/integrate/integration-options/enskit" | ||
| /> | ||
|
|
||
| <LinkCard | ||
| title="ENS Omnigraph API" | ||
| description="The GraphQL API behind all of the above." | ||
| href="/docs/integrate/omnigraph" | ||
| /> |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Goader Great work shipping these two new pages!
Could you please also update the text here on the "AI / LLM Tooling" page?
The general message we should communicate here is:
enscliandensskills. (link to each of the pages you created for these)