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.