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

# Install Fimo skills in your agent

> Teach your AI coding agent how to work with Fimo — skills, rule files, and how to keep them current.

Fimo ships **skills** and **rule files** that make your coding agent fluent in the `fimo` workflow — schemas, entries, forms, `t()` labels, `fimo/ui` components, deploys, and more. `fimo init` sets these up automatically; this page covers installing them on their own and adding more agents later.

## Install skills

Run the CLI via `npx fimo@latest` — do not install `fimo` globally. Because npx runs from an ephemeral cache with no stable path to symlink into, use **copy mode**:

```bash theme={null}
npx fimo@latest skills install --mode=copy       # interactive agent picker
```

Pick your agent(s), or name them explicitly:

```bash theme={null}
fimo skills install --agents=claude-code,cursor  # explicit list
fimo skills install -a claude-code -a cursor     # repeatable form
fimo skills install --agents=claude-code --yes   # skip the preview prompt (scripts)
```

`fimo skills install` shows a one-screen preview of every path it will touch before writing, and prints exactly which files it wrote — no silent magic.

<Note>
  `fimo skills install` is context-aware. **Outside** a Fimo project it installs only the global skills. **Inside** a project it also writes the project `fimo` skill and generates the per-agent rule file — one command, full setup.
</Note>

## The two skills

<CardGroup cols={2}>
  <Card title="fimo-cli (global)" icon="terminal">
    Installed once per machine. Covers the CLI workflow — creating projects, building content, running the app locally, deploying. Loads in any compatible AI tool.
  </Card>

  <Card title="fimo (project)" icon="folder">
    Installed into the project, version-locked to the project's `fimo` package. Covers the code-side surface: schemas, forms, `t()`, `fimo/ui` components.
  </Card>
</CardGroup>

## Per-agent rule files

Alongside the universal `AGENTS.md`, `fimo init` generates the right rule file for each AI tool you select:

| Agent                             | File(s) generated                     |
| --------------------------------- | ------------------------------------- |
| Claude Code                       | `CLAUDE.md` + `.claude/settings.json` |
| Cursor                            | `.cursor/rules/fimo.mdc`              |
| Windsurf                          | `.windsurfrules`                      |
| Gemini CLI                        | `GEMINI.md`                           |
| Codex / OpenCode / Aider / others | none — they read `AGENTS.md` natively |

## Keep skills current

```bash theme={null}
fimo skills sync            # refresh installed skills (global + project)
fimo rules sync             # regenerate missing per-agent rule files (additive)
```

Global skills auto-refresh whenever a newer CLI runs, and the project skill auto-refreshes when the `fimo` package version bumps. Invoke `sync` by hand when you want to force a refresh.

<Tip>Adding a teammate on a different tool? Run `fimo skills install --agents=cursor` from inside the project — global skill + project skill + rule file in one shot.</Tip>

## What's next

<Columns cols={3}>
  <Card title="Connect your coding agent" icon="plug" href="/docs/ai/connect-agents">
    Supported agents and how Fimo enhances them.
  </Card>

  <Card title="Skills & rules" icon="book" href="/docs/ai/skills-and-rules">
    How the skill + rule layers fit together.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/docs/get-started/quickstart">
    From `fimo init` to a live site.
  </Card>
</Columns>