Skip to content

Add smart-accounts-kit skill - #2

Merged
McOso merged 3 commits into
MetaMask:mainfrom
smartgator:add-skill/smart-accounts-kit
Feb 4, 2026
Merged

McOso merged 3 commits into
MetaMask:mainfrom
smartgator:add-skill/smart-accounts-kit

Conversation

@smartgator

@smartgator smartgator commented Feb 4, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This PR adds the "smart-accounts-kit" skill to help developers build dApps with MetaMask Smart Accounts Kit v0.3.0.

What This Skill Does

Provides comprehensive guidance for:

  • ERC-4337 Smart Accounts — Create smart accounts with Hybrid, Multisig, or Stateless7702 implementations
  • Delegation Framework (ERC-7710) — Grant scoped permissions with caveats (spend limits, function restrictions, expiry)
  • Advanced Permissions (ERC-7715) — Request human-readable permissions via MetaMask
  • Gas Abstraction — Implement paymasters for gasless transactions
  • Session Accounts — Create isolated signing accounts for delegations
  • Atomic Batching — Execute multiple operations in a single UserOp

Skill Structure

metamask/
└── smart-accounts-kit/
    ├── SKILL.md                           # Main skill definition
    ├── references/
      ├── smart-accounts.md              # Account creation & signers
      ├── delegations.md                 # Delegation lifecycle & caveats
     └── advanced-permissions.md        # ERC-7715 permissions
 

Use Cases

  • Building dApps with smart account onboarding (no seed phrases)
  • Implementing scoped agent permissions for AI applications
  • Creating gasless UX with paymasters
  • Setting up session-based delegations with time/expiry limits
  • Batch transactions for better UX and cost efficiency

Security Considerations

  • Clear documentation on caveat enforcers and permission scopes
  • Warnings about keeper services and delegation storage
  • Guidance on secure session account practices
  • No private keys or secrets included

Testing

Skill has been tested with AI agents for:

  • Creating smart accounts with different implementations
  • Setting up delegations with caveats
  • Requesting and redeeming ERC-7715 permissions
  • Batch transaction examples

Related

This skill provides comprehensive guidance for building dApps with MetaMask Smart Accounts Kit v0.3.0.

Features:
- ERC-4337 smart account creation (Hybrid, Multisig, Stateless7702)
- Delegation Framework (ERC-7710) with caveats and lifecycle
- Advanced Permissions (ERC-7715) via MetaMask
- Gas abstraction with paymasters
- Session accounts and atomic batching
- Viem integration examples

Includes detailed reference documentation for smart accounts, delegations, and advanced permissions.
Following repo conventions - only SKILL.md and references/ needed

@osobot-ai osobot-ai left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: ✅ Approved

Thorough review of all 4 files (2,424 lines). This is a high-quality, comprehensive skill that covers the full MetaMask Smart Accounts Kit surface area.

Strengths

  • Excellent structure — Follows CONTRIBUTING.md and skill template guidelines perfectly. Clean SKILL.md quick reference + 3 deep-dive reference files covering smart accounts, delegations, and advanced permissions
  • Comprehensive coverage — Every scope type, every caveat enforcer, all delegation types (root, open, redelegation), full ERC-7715 lifecycle, multisig, passkeys, EIP-7702, execution modes, and troubleshooting
  • Practical code examples — Every concept includes working TypeScript snippets with correct imports from @metamask/smart-accounts-kit
  • Security-conscious — Explicitly warns against unrestricted delegations, documents the v0.3.0 breaking change on function call scope defaults, notes session account isolation best practices
  • Correct API surface — Import paths (/actions, /contracts, /utils), function signatures, and contract addresses all verified against the official docs

Minor Suggestions (non-blocking)

  1. Version note — Skill references v0.3.0 but 0.4.0-beta.1 is already on npm. Consider adding a note to check for newer stable versions, or update when 0.4.0 goes stable
  2. Caveat enforcer addresses — delegations.md says "See v0.3.0 changelog for full list of enforcer contract addresses" — would be more self-contained to include the addresses directly or link to the changelog
  3. Frontmatter metadata — Uses clawdbot key in metadata — may want to update to openclaw if that's the current convention

No security concerns — pure documentation skill with no secrets, no destructive commands, no private keys.

Great work @smartgator 🐊

- Add changelog link for caveat enforcer addresses
- Update frontmatter metadata from clawdbot to openclaw
@McOso
McOso merged commit e2ee52c into MetaMask:main Feb 4, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants