controller-presets

Generate validated Cartridge Controller preset configs for SN_MAIN and SN_SEPOLIA.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shariqazeem/Prophecy-Roguelite --skill controller-presets-shariqazeem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: controller-presets
Source: https://github.com/shariqazeem/Prophecy-Roguelite/tree/main/.agents/skills/controller-presets
Command: npx skills add https://github.com/shariqazeem/Prophecy-Roguelite --skill controller-presets-shariqazeem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams struggle to produce correct, validated Cartridge Controller presets that wire origin verification, session policies, theming, paymaster behavior, and optional iOS passkey configuration into a CI-ready config.json for deployment and CDN hosting. This Skill reduces confusion and merge failures by guiding users through required fields, network-specific rules, and common validation pitfalls.

Core Features & Use Cases

  • Interactive Requirements Gathering: Step-by-step questions to collect project name, target networks, origins, contract addresses and entrypoints, theme assets, and AASA app IDs.
  • Policy & Paymaster Guidance: Build chain-specific policies, mark methods as paymastered or not, add predicates, and surface warnings for sensitive entrypoints like approve.
  • Asset Packaging & Validation: Ensure theme icons/covers are referenced and placed alongside config.json, enforce origin formatting rules, snake_case entrypoints, separate network addresses, and AASA format constraints.
  • PR & Integration Instructions: Produce a PR-ready configs/<name>/ directory layout and explain how to consume the preset from the Controller client and CI validation steps.

Quick Start

Create a Cartridge Controller preset for game prophecy including origins, session policies for SN_MAIN and SN_SEPOLIA, theme assets, and a PR-ready config.json.

Frequently Asked Questions about controller-presets

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

FAQPage Schema
How do I create a Cartridge Controller preset config.json for Starknet?

Cartridge Controller presets require enforcing no-protocol origins, snake_case contract entrypoints, separate network addresses for SN_MAIN and SN_SEPOLIA, and referenced icon/cover asset files. The generated config.json must also apply paymaster predicates and VRF inclusion rules.

How do I configure iOS AASA app IDs for Cartridge Controller presets?

Yes, you can mark specific contract methods as paymastered within your Cartridge Controller preset. The configuration process guides you through building chain-specific policies, adding predicates, and surfacing warnings for sensitive entrypoints like approve.

How to package Cartridge Controller preset assets for CDN deployment?

Before generating a preset, gather your project name, target networks (SN_MAIN or SN_SEPOLIA), origins, contract addresses, entrypoints, theme assets, and AASA app IDs. This interactive requirements collection ensures all required fields are correctly populated.

Why does my Cartridge Controller preset validation fail on origins?

After generating your config.json, the next step is submitting the PR-ready configs/<name>/ directory and consuming the preset from the Controller client. You must then run CI validation steps to verify contract entrypoints, paymaster predicates, and asset packaging.