controller-presets

What problem does it solve?

This Skill guides teams through creating, validating, and submitting Cartridge Controller presets so they can configure origin verification, session policies, theming, paymaster behavior, and optional iOS passkey (AASA) entries without guesswork.

Core Features & Use Cases

• Interactive Questionnaire: Walks teams step-by-step to collect project name, target networks (SN_MAIN / SN_SEPOLIA), origins, contract addresses, and method entrypoints.
• Policy & Paymaster Guidance: Helps define per-chain contract policies, paymaster predicates, and flags security-sensitive entrypoints (e.g., approve) with recommended mitigations.
• Theme & Assets Handling: Collects icon/cover assets and primary color, explains asset placement and optimization expectations.
• AASA and Mobile Passkey Support: Validates Apple Team ID and bundle ID formatting for aggregated AASA entries when a native iOS app exists.
• Validation & PR Workflow: Assembles config.json, runs through a validation checklist (origins, chain IDs, entrypoint naming, AASA format, asset references), and guides submitting a PR to the presets repo.

Quick Start

Create a Controller preset named my-game for SN_MAIN and SN_SEPOLIA with origins example.com, include per-chain contract addresses and snake_case entrypoints, add a theme icon, and present the assembled config.json for validation.