feat(docs): Agent Skills registry + Templates gallery by alexander-sei · Pull Request #36 · sei-protocol/sei-docs

alexander-sei · 2026-06-27T18:04:55Z

Agent Skills registry

6 Foundation skills under .mintlify/skills/<name>/SKILL.md — sei-contracts, sei-frontend, sei-precompiles, sei-nodes, sei-payments, sei-security. Mintlify serves these at /.well-known/skills/, installable via npx skills add https://docs.sei.io.
Registry page at /ai/skills with a filterable card grid (snippets/skills-registry.jsx), a per-skill copy-install command, and a community-skills CTA.
.gitignore: .mintlify/ is the Mintlify CLI's local cache and was fully ignored. Changed to .mintlify/* + !.mintlify/skills/ so the skills subtree ships while the cache stays ignored.

Templates gallery

Gallery at /evm/templates (next to create-sei) listing the real @sei-js/create-sei entries — the Next.js + wagmi template and the precompiles extension — each with a working one-command scaffold.

Navigation + redirects (`docs.json`)

Added ai/skills and evm/templates to the nav.
Redirects /skills → /ai/skills and /templates → /evm/templates.

Notes

Skills link to live docs for governance-adjustable params (gas, deposits) rather than hardcoding values that can change.
Chain configs (sei / seiTestnet) are imported from viem/chains; @sei-js/precompiles is used for precompile addresses/ABIs.
Community/ecosystem skills are presented as a contribution CTA — they can be listed as teams publish them.

🤖 Generated with Claude Code

Closes the P1 #4 (Agent Skills registry) and P1 #5 (Templates gallery) gaps from the Sei-vs-Solana docs review. Skills (P1 #4): - 6 Foundation skills under .mintlify/skills/<name>/SKILL.md (sei-contracts, sei-frontend, sei-precompiles, sei-nodes, sei-payments, sei-security), installable via `npx skills add docs.sei.io` and served at /.well-known/skills/. - Registry page at /ai/skills with a filterable grid (snippets/skills-registry.jsx) and one-command install. - .gitignore: un-ignore .mintlify/skills/ so the skills deploy (the rest of .mintlify/ stays ignored as a local cache). Templates (P1 #5): - Gallery at /evm/templates listing the real @sei-js/create-sei entries only (Next.js + wagmi template, precompiles extension) — no fabricated demos or screenshots. Nav + redirects (docs.json): add ai/skills and evm/templates; redirect /skills -> /ai/skills and /templates -> /evm/templates. SSTORE gas is cited as 72,000 (same on both networks, governance Proposal #109), consistent with /evm/differences-with-ethereum. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

mintlify · 2026-06-27T18:04:58Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
sei-docs	🟢 Ready	View Preview	Jun 27, 2026, 6:05 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

cursor · 2026-06-27T18:05:00Z

PR Summary

Low Risk
Documentation, static skills content, and UI snippets only—no runtime or auth changes.

Overview
Adds six Foundation agent skills under .mintlify/skills/ (contracts, frontend, precompiles, nodes, payments, security) as installable SKILL.md playbooks, plus a Skills Registry at /ai/skills with a filterable card grid (snippets/skills-registry.jsx) and npx skills add https://docs.sei.io install flow. .gitignore now ignores .mintlify/* but keeps !.mintlify/skills/ so skills ship with the repo while Mintlify cache stays untracked.

Adds an /evm/templates gallery documenting @sei-js/create-sei starters (Next.js + wagmi and the precompiles extension). docs.json wires ai/skills and evm/templates into nav and adds redirects from /skills and /templates.

^{Reviewed by Cursor Bugbot for commit 8c8132d. Bugbot is set up for automated code reviews on this repo. Configure here.}

- Skills: import sei/seiTestnet viem chains from viem/chains (the @sei-js/precompiles package only exports seiLocal); keep @sei-js/precompiles for precompile addresses/ABIs. Fixes the runnable examples in sei-precompiles, sei-security, and sei-contracts. - templates: correct the create-sei stack to Next.js 15 / React 19, add RainbowKit, note Tailwind v4. - skills install command uses the https:// scheme (npx skills add https://docs.sei.io). - sei-contracts: separate the 6-decimal usei micro-denom from the 18-decimal EVM wei representation. - Drop the imprecise "(proposal 99)" CosmWasm-freeze attribution (per SIP-3); deep-link "live value" pointers to /evm/differences-with-ethereum (and /evm/networks). - sei-precompiles: getSeiAddr reverts or returns "" when unassociated. - sei-nodes: replace the ~28h figure with ~100k blocks; name the current evm-ss-split flag for Giga storage. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Independent-review fixes for the Agent Skills registry (PR #36): - sei-security: getSeiAddr REVERTS for an unassociated address (verified against sei-chain precompiles/addr/addr.go:128-132 — returns a non-nil error, no empty-string path). The old `require(bytes(actual).length != 0)` guard was dead code; wrap the call in try/catch and treat the revert as "not associated". Fix the off-chain prose to match. - sei-precompiles: drop the "reverts or returns ''" hedge so all skills agree the call reverts when unassociated. - All skills: remove the false "no safe/finalized block tags" claim — on Sei safe/finalized/latest all resolve to the same instantly-final block (per evm/differences-with-ethereum.mdx), so just query latest. - ai/skills + snippet: clarify every card copies the same full-set install command; add per-skill aria-labels for accessibility. - sei-frontend: @sei-js/precompiles ships only the seiLocal viem chain, not sei/seiTestnet. - sei-contracts/sei-security: use ~22,100 for the revm SSTORE figure to match differences-with-ethereum.mdx. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

cursor

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c25bfd8. Configure here.}

Update skill documentation to use seiTestnet by default instead of mainnet in code examples. Replace hardcoded chain IDs with testnet chain objects and add comments reminding developers to get explicit approval before switching to mainnet (1329). This enforces safer defaults and makes the approval requirement explicit in the code.

mintlify Bot deployed to staging June 27, 2026 18:05 View deployment

cursor Bot reviewed Jun 27, 2026

View reviewed changes

Comment thread .mintlify/skills/sei-security/SKILL.md Outdated

mintlify Bot deployed to staging June 29, 2026 00:53 View deployment

mintlify Bot deployed to staging June 29, 2026 11:15 View deployment

cursor Bot reviewed Jun 29, 2026

View reviewed changes

Comment thread .mintlify/skills/sei-security/SKILL.md Outdated

Comment thread .mintlify/skills/sei-frontend/SKILL.md Outdated

mintlify Bot deployed to staging June 29, 2026 11:23 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(docs): Agent Skills registry + Templates gallery#36

feat(docs): Agent Skills registry + Templates gallery#36
alexander-sei wants to merge 4 commits into
mainfrom
docs/skills-registry-and-templates

alexander-sei commented Jun 27, 2026 •

edited

Loading

Uh oh!

mintlify Bot commented Jun 27, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Jun 27, 2026 •

edited

Loading

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

alexander-sei commented Jun 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Agent Skills registry

Templates gallery

Navigation + redirects (docs.json)

Notes

Uh oh!

mintlify Bot commented Jun 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jun 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

alexander-sei commented Jun 27, 2026 •

edited

Loading

Navigation + redirects (`docs.json`)

mintlify Bot commented Jun 27, 2026 •

edited

Loading

cursor Bot commented Jun 27, 2026 •

edited

Loading