feat(docs): Agent Skills registry + Templates gallery

[alexander-sei]

Summary

Closes two P1 gaps from the Sei-vs-Solana docs review: an Agent Skills registry (#4) and a Templates gallery (#5).

P1 #4 — 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 docs.sei.io.
• Registry page at /ai/skills (AI tab) with a filterable card grid (snippets/skills-registry.jsx), per-skill copy-install commands, 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.

P1 #5 — Templates gallery

• Gallery at /evm/templates (EVM tab, next to create-sei). Lists only the real @sei-js/create-sei entries — the Next.js + wagmi template and the precompiles extension. No fabricated templates, demo links, or screenshots (create-sei ships exactly one template + one extension today).

Nav + redirects (docs.json)

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

How it was built & verified

• The 6 skills were authored and then adversarially fact-checked — the verify pass caught and fixed real issues (TypeScript syntax in a node example, a fabricated validator-address length, a stale Pyth Entropy API signature).
• Cross-checked against source docs: USDC addresses and @sei-js/x402-* packages match evm/usdc-on-sei.mdx / ai/x402.mdx exactly; all 11 precompile addresses match canon; chain IDs / RPC URLs correct throughout.
• SSTORE gas is cited as 72,000 (same on both networks, governance Proposal #109), consistent with evm/differences-with-ethereum.mdx, with the forge --fork-url ~22k caveat noted.
• Full internal-link + anchor sweep across all new files: 0 dead links, 0 broken anchors. YAML frontmatter parses for all 6 skills.
• Rendered locally via mint dev + headless browser: /ai/skills and /evm/templates both return 200, the registry snippet hydrates (6 cards, filter narrows correctly), dark mode is safe, no page errors.

Notes for reviewers

• The skills deliberately link to live docs for governance-adjustable params rather than hardcoding values that can change.
• Community/ecosystem skills (DragonSwap, Yei, etc.) are presented as a contribution CTA, not fabricated entries — they can be listed as teams publish them.

🤖 Generated with Claude Code

[mintlify]

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]

PR Summary

Low Risk
Documentation and static skill content only; no application runtime, auth, or on-chain logic changes.

Overview
Adds six Foundation agent skills under .mintlify/skills/ (contracts, frontend, precompiles, nodes, payments, security) as installable SKILL.md playbooks, and updates .gitignore so that subtree is tracked while the rest of .mintlify/ stays ignored.

Introduces an Agent Skills registry at /ai/skills with snippets/skills-registry.jsx (filterable cards, npx skills add docs.sei.io, links to docs), plus a Templates gallery at /evm/templates documenting real @sei-js/create-sei starters only.

docs.json adds nav entries for both pages and permanent redirects from /skills and /templates.

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

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

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

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

[cursor]

Wrong unassociated Addr behavior

Medium Severity

The new security skill tells readers that unassociated EVM addresses yield an empty string from getSeiAddr, and its requireAssociated helper treats zero-length strings as “not linked.” On Sei, getSeiAddr reverts when the address is not associated, matching learn/accounts.mdx and the sei-frontend skill’s isError handling—not an empty return.

 

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