> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inco.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Build with AI

> Use the Inco agent skill to build confidential smart contracts, dApps, and games with your AI coding assistant.

## 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

<Tabs>
  <Tab title="Any agent (recommended)">
    Install with the [Vercel `skills`](https://github.com/vercel-labs/skills) CLI, which works with Claude Code, Codex, Cursor, Cline, and 70+ more:

    ```bash theme={null}
    npx skills add Inco-fhevm/skills
    ```

    To install for a specific agent, add the `-a` flag, for example `npx skills add Inco-fhevm/skills -a codex`.
  </Tab>

  <Tab title="Claude Code plugin">
    Install as a native plugin, which gives you the namespaced `/inco:lightning` command and the `inco` umbrella for future skills:

    ```bash theme={null}
    /plugin marketplace add Inco-fhevm/skills
    /plugin install inco@inco
    ```
  </Tab>

  <Tab title="Manual">
    [Download the skill (zip)](https://github.com/Inco-fhevm/skills/raw/main/assets/inco-lightning.zip), unzip it, and copy the skill folder into your agent's skills directory:

    ```bash theme={null}
    mkdir -p ~/.claude/skills
    cp -R lightning ~/.claude/skills/lightning
    ```
  </Tab>
</Tabs>

## 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:

```text theme={null}
"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

<CardGroup cols={2}>
  <Card title="Inco Lightning reference" icon="book-open">
    The `@inco/lightning` Solidity library (encrypted types, `e.allow`, attestation) and the `@inco/lightning-js` SDK and Foundry/Hardhat setup with a local covalidator.
  </Card>

  <Card title="Game-design layer" icon="dice">
    The decision tree, archetype catalog, cross-cutting patterns (confidential randomness, equality-match, encrypted packing), the two settlement models, and the frontend loop.
  </Card>

  <Card title="Worked contracts" icon="file-contract">
    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.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Inco Skills repo" icon="github" href="https://github.com/Inco-fhevm/skills">
    Browse the skill source, worked contracts, and full install options.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Set up the Inco toolchain and run your first confidential contract.
  </Card>
</CardGroup>