controller-presets

Create Cartridge Controller presets with validation for SN_MAIN and SN_SEPOLIA.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Kepler22bee/House-of-Stark --skill controller-presets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: controller-presets
Source: https://github.com/Kepler22bee/House-of-Stark/tree/main/contracts/.agents/skills/controller-presets
Command: npx skills add https://github.com/Kepler22bee/House-of-Stark --skill controller-presets

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about controller-presets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Cartridge Controller presets for Starknet mainnet and sepolia?

To configure Cartridge Controller presets, you collect per-chain contract addresses, methods, assets, and origins for SN_MAIN and SN_SEPOLIA. The preset workflow assembles this data into a config.json file for deployment to the cartridge-gg/presets repository.

What format should origins and entrypoints use when building a Cartridge Controller preset?

Origins must be formatted without protocol prefixes, and entrypoints need to use snake_case naming. The preset validation checklist verifies these formatting rules to ensure proper configuration before submission.

How do I add iOS passkey support to a Cartridge Controller preset?

To add iOS passkey support, you include optional AASA entries in the preset by providing a valid Apple Team ID and bundle ID. The AASA app IDs must match the exact TEAMID.BUNDLEID format for successful validation.

How do I set up paymaster settings and session policies for a Cartridge Controller?

Setting up paymaster settings and session policies involves defining per-chain contract policies and paymaster predicates. The workflow flags security-sensitive entrypoints like approve and recommends appropriate mitigations.

Can I submit a Cartridge Controller preset without validating the asset file references?

No, you cannot submit a preset without valid asset references because the validation checklist confirms that referenced asset files exist in the preset directory. This ensures icons, covers, and other theme assets are correctly bundled before deployment.

What is a Cartridge Controller preset and when do I need to create one?

A Cartridge Controller preset is a configuration file that defines origin verification, session policies, theming, and paymaster behavior. You need to create one when preparing your application for deployment to SN_MAIN or SN_SEPOLIA networks.