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

# Claude Code Skills

> Register lim commands as Claude Code skills for natural terminal-based accounting.

# Claude Code Skills

lim can register all its command groups as [Claude Code skills](https://docs.anthropic.com/en/docs/claude-code/skills), making every lim capability available through natural conversation in your terminal.

## Installation

<CodeGroup>
  ```bash Option A: via lim CLI theme={null}
  npx @lim-labs/lim skills add
  ```

  ```bash Option B: via skills CLI theme={null}
  npx skills add @lim-labs/lim
  ```
</CodeGroup>

This registers lim's 29 command groups as Claude Code skills in your project's `.claude/skills/` directory.

After installation, restart Claude Code to pick up the new skills.

## What Gets Registered

Every lim command group becomes a skill that Claude can invoke:

| Skill              | Commands                                | Description                    |
| ------------------ | --------------------------------------- | ------------------------------ |
| `lim-add`          | `lim add`                               | Natural language journal entry |
| `lim-journals`     | `lim journals list/show/create/reverse` | Journal entry management       |
| `lim-reports`      | `lim reports tb/pl/bs/ss/cs/gl`         | Financial reports              |
| `lim-companies`    | `lim companies list/use/create`         | Company management             |
| `lim-accounts`     | `lim accounts list/show`                | Chart of accounts              |
| `lim-stats`        | `lim stats`, `lim dashboard`            | Learning engine metrics        |
| `lim-import`       | `lim import`                            | Import from other software     |
| `lim-bank`         | `lim bank list/sync/match`              | Bank account operations        |
| `lim-invoices`     | `lim invoices list/create/send`         | Invoice management             |
| `lim-documents`    | `lim documents list/upload`             | Document management            |
| `lim-labels`       | `lim labels list/create`                | Label/tag management           |
| `lim-tax`          | `lim tax codes/withholding`             | Tax code management            |
| `lim-periods`      | `lim periods list/close`                | Fiscal period management       |
| `lim-alerts`       | `lim alerts list/create`                | Alert rule management          |
| `lim-scenarios`    | `lim scenarios list/create/diff`        | Scenario analysis              |
| `lim-approvals`    | `lim approvals list/approve/reject`     | Approval workflows             |
| `lim-contracts`    | `lim contracts list/create`             | Contract management            |
| `lim-employees`    | `lim employees list/create`             | Employee management            |
| `lim-payroll`      | `lim payroll run/list`                  | Payroll processing             |
| `lim-expenses`     | `lim expenses list/create/approve`      | Expense reports                |
| `lim-fixed-assets` | `lim fixed-assets list/depreciate`      | Fixed asset management         |
| `lim-fx`           | `lim fx rates/convert`                  | Foreign exchange               |
| `lim-accruals`     | `lim accruals list/generate`            | Accrual schedules              |
| `lim-opening`      | `lim opening-balance set`               | Opening balance setup          |
| `lim-members`      | `lim members list/invite`               | Team member management         |
| `lim-auth`         | `lim auth login/logout/whoami`          | Authentication                 |
| `lim-mcp`          | `lim mcp add/serve`                     | MCP server management          |
| `lim-webhooks`     | `lim webhooks list/create`              | Webhook management             |
| `lim-events`       | `lim events list/replay`                | Event inspection               |

## Usage Examples

Once skills are registered, Claude Code can use them naturally in conversation:

### Daily Bookkeeping

```
You: Record today's expenses: AWS ¥11,000 credit card, lunch meeting
     with client ¥5,500 cash, and taxi to office ¥2,200 Suica.

Claude: I'll record all three expenses.

        $ lim add "AWS 11000 yen credit card"
        ✅ Communication 10,000 / Accounts payable 11,000 + Input VAT 1,000

        $ lim add "lunch meeting with client 5500 yen cash"
        ✅ Entertainment 5,000 / Cash 5,500 + Input VAT 500

        $ lim add "taxi to office 2200 yen Suica"
        ✅ Travel 2,000 / Cash 2,200 + Input VAT 200

        All three entries recorded. Today's total: ¥18,700.
```

### Financial Review

```
You: How did we do in Q1?

Claude: $ lim reports pl --from 2026-01-01 --to 2026-03-31
        $ lim reports bs --as-of 2026-03-31
        $ lim reports cs --from 2026-01-01 --to 2026-03-31

        Q1 Summary:
        - Revenue: ¥3,300,000
        - Net income: ¥2,590,000 (78% margin)
        - Cash position: ¥2,450,000
        - Operating cash flow: ¥2,260,000

        Strong quarter. Revenue up 15% vs Q4 2025.
```

### Month-End Close

```
You: Let's do the March close.

Claude: I'll check everything step by step.

        $ lim journals list --from 2026-03-01 --to 2026-03-31 --status draft
        3 draft entries found. Let me review them...

        $ lim bank list --unmatched
        2 unmatched bank transactions. Processing...

        $ lim reports tb --from 2026-03-01 --to 2026-03-31
        Trial balance checks out. Debits = Credits ✓

        $ lim accruals generate --period 2026-03
        Generated 2 accrual entries for March.

        Everything looks clean. Ready to close?

You: Yes, close it.

Claude: $ lim periods close --period 2026-03
        ✅ March 2026 closed.
```

### Scenario Analysis

```
You: What happens to our runway if we hire two more engineers?

Claude: $ lim scenarios create --name "Hire 2 engineers" \
          --description "Two senior engineers at ¥700k/month each"

        $ lim scenarios generate --id <scenario-id>

        $ lim scenarios diff --id <scenario-id>

        Impact analysis:
        - Additional monthly cost: ¥1,820,000
          (salary ¥1,400,000 + social insurance ¥210,000 + equipment ¥210,000 amortized)
        - Current runway: 3.5 months
        - Post-hire runway: 1.8 months

        You'd need to close a funding round within 2 months.
```

## Skills vs MCP

Both skills and MCP let AI agents interact with lim. Here's when to use each:

|                    | Skills                         | MCP                               |
| ------------------ | ------------------------------ | --------------------------------- |
| **Best for**       | Claude Code terminal sessions  | Any MCP-compatible client         |
| **Interface**      | CLI commands                   | Structured tool calls + resources |
| **Authentication** | CLI token                      | CLI token or API key              |
| **Output**         | Human-readable terminal output | Structured JSON                   |
| **Setup**          | `npx @lim-labs/lim skills add` | `npx @lim-labs/lim mcp add`       |

<Tip>
  You can use both simultaneously. Skills are great for interactive sessions where you want
  human-readable output. MCP is better for automated workflows where structured data matters.
</Tip>

## Updating Skills

When lim is updated with new commands, re-run the installation:

```bash theme={null}
npx @lim-labs/lim skills add --force
```

This overwrites existing skill definitions with the latest versions.

## Removing Skills

```bash theme={null}
npx @lim-labs/lim skills remove
```

This removes all lim skills from your Claude Code configuration.