Skip to main content

​
Overview

The Inco agent skill teaches your AI coding assistant how to build confidential applications on Inco Lightning, covering encrypted types, programmable access control, and attestation across the @inco/lightning Solidity library and the @inco/lightning-js SDK. It works in Claude Code, Codex, Cursor, and 70+ agents, and brings game-design sense to your workflow, helping you decide what must stay private, which Inco feature to reach for, and how to wire it together end to end.

​
Install

​
Use the skill

Invoke /lightning (or /inco:lightning if you installed the Claude Code plugin), or just describe what you want, and it activates on its own when your request involves confidential or Inco work: 
"build a confidential sealed-bid auction on Inco"
"what should be private in my on-chain poker game?"
"add a hidden-roles mafia mechanic to my confidential game"
Start a fresh project with npx create-inco-app, or ask the skill to scaffold the Inco starter for you.

​
What it does

  • Decides what to hide. Answer two questions (what’s secret, and when does it reveal?), and it routes you to the right pattern.
  • Knows the genres. A catalog of 8 confidential-game archetypes: encrypted board, fog-of-war (Battleship), hidden hand (poker), hidden roles (mafia), sealed-bid auction, simultaneous-move (RPS), provably-fair casino, and word/code guessing.
  • Picks the settlement model. On-chain attestation (for wagers) vs. private decrypt plus client-side (for single-player), with an honest line on when each is safe to use.
  • Writes the contract and the frontend. The encrypt → transact → reveal/decrypt → render loop, fee handling, and attestation verification.

​
What’s inside

Inco Lightning reference

The @inco/lightning Solidity library (encrypted types, e.allow, attestation) and the @inco/lightning-js SDK and Foundry/Hardhat setup with a local covalidator.

Game-design layer

The decision tree, archetype catalog, cross-cutting patterns (confidential randomness, equality-match, encrypted packing), the two settlement models, and the frontend loop.

Worked contracts

Full example contracts to learn from: a wager game with on-chain settlement, a single-player game with client-side reveal, and a confidential ERC-20 token.

​
Next steps

Inco Skills repo

Browse the skill source, worked contracts, and full install options.

Quickstart

Set up the Inco toolchain and run your first confidential contract.