controller-signers

Configure multi-method Cartridge Controller authentication for passkeys, OAuth, and wallets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill centralizes and documents multi-method authentication for Cartridge Controller so teams can implement secure, recoverable, and branded signin flows across web and native game clients.

Core Features & Use Cases

  • Multiple signer support: WebAuthn passkeys, social OAuth (Google, Discord, Twitter), Starknet wallets (Argent, Braavos), and EVM wallets (MetaMask, Phantom EVM, Rabby, WalletConnect).
  • Dynamic flows & branded UX: Configure signup options per connection, show single-branded buttons for single-option setups, and fall back to popup/redirect OAuth when needed.
  • Recovery & management: Add/remove backup signers, recommend diversity for account recovery, and auto-sync Starknet accounts via accountsChanged listeners.
  • Operational details: Includes guidance for chain switching, transaction confirmation polling, mobile vs desktop option sets, and limitations of OAuth in webviews.
  • Use Case: A game implements passkeys for primary auth, Google for onboarding, and Argent as a Starknet backup to ensure players can recover accounts and transact without repeated wallet popups.

Quick Start

Connect the controller with signup options webauthn, google, and argent to enable passkey, social, and Starknet wallet authentication.

Frequently Asked Questions about controller-signers

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

FAQPage Schema
How do I configure multi-method authentication for a Cartridge Controller?

Configure multi-method authentication by setting up signup options like WebAuthn passkeys, social OAuth, and external wallets to enable dynamic flows and branded single-option buttons for game frontends.

Can I use WebAuthn passkeys and social OAuth together for account recovery?

Yes, WebAuthn passkeys and social OAuth can be combined. Adding multiple signers like Google alongside passkeys provides backup authentication methods to ensure secure account recovery.

Does Cartridge Controller support Starknet wallets like Argent and Braavos?

Yes, Cartridge Controller supports Starknet wallets including Argent and Braavos. It uses wallet connection hooks and accountsChanged listeners to auto-sync Starknet accounts during authentication.

What are the limitations of using OAuth in webviews for wallet authentication?

OAuth in webviews has operational limitations, often requiring popup or redirect fallbacks. The Skill provides guidance on mobile versus desktop option sets and transaction confirmation polling to mitigate these issues.

How do I add or remove backup signers for account recovery?

Add or remove backup signers through the Controller's recovery management features. It recommends signer diversity, allowing players to configure backup options like an Argent Starknet wallet alongside primary passkey authentication.

Do I need OIDC token validation to set up social OAuth with Cartridge Controller?

Yes, OIDC token validation is required for OAuth authentication. This ensures secure token handling when integrating social logins like Google, Discord, or Twitter into your game's signup flow.