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

# How to Install a DualEntry Accounting Skill

> Install a DualEntry accounting skill in Claude, Claude Code, or another agent, connect it to your books through the MCP server, and keep the skill up to date.

You install a DualEntry accounting skill by copying its definition into your AI agent, then connecting the agent to DualEntry through the MCP server. For what each skill does and the defaults it uses, see [Accounting Skills: DualEntry Skills for AI Agents](https://docs.dualentry.com/accountants/ai-automation/mcp/accounting-skills.md).

## Before you start

A skill needs three things before it can answer questions from your books. You need an agent that loads skills, a DualEntry login that can read the skill's records, and the skill's name.

* **An agent that supports Agent Skills**: Claude on the web and desktop, Claude Code, and other agents that follow the [Agent Skills specification](https://agentskills.io) can load a skill. Check your agent's documentation if you're not sure.
* **A DualEntry user with the right access**: The agent reads your books as the user who connects it, so that user's role must be able to view the records the skill covers. For example, the payables skills read bills and vendors. A role that can only view records also keeps the agent read-only.
* **The skill you want**: Browse the catalog on [dualentry.com/skills](https://www.dualentry.com/skills), or the [skill catalog](https://docs.dualentry.com/accountants/ai-automation/mcp/accounting-skills.md#the-skill-catalog) on this site, and note the skill's name, such as `dualentry-bills-due-soon`.

You can install as many skills as you like, and one MCP connection serves all of them. If your agent is already connected to DualEntry, you can skip that step below.

## Install the skill

These steps copy one skill into your agent. Repeat them for each skill you want.

1. Open [dualentry.com/skills](https://www.dualentry.com/skills) and choose the skill.
2. In its **Skill definition** section, select the copy icon next to `SKILL.md`.
3. Save the text as a file named `SKILL.md`, in a folder with the skill's name. For example, save `dualentry-bills-due-soon/SKILL.md`. Keep the folder name the same as the `name` line at the top of the file.
4. Add the folder to your agent:
   * **Claude (web and desktop)**: Compress the folder into a ZIP file. Go to **Customize > Skills** and upload the ZIP file. Skills need code execution, which you turn on under **Settings > Capabilities**.
   * **Claude Code**: Put the folder in `~/.claude/skills/` to use the skill in every project, or in `.claude/skills/` inside one project.
   * **Other agents**: Put the folder wherever your agent loads Agent Skills from, as its documentation describes.
5. Restart the agent, or start a new conversation, so it loads the new skill.

The skill now appears in your agent's list of skills. The agent loads it on its own when a question matches the skill's description, so you don't need to name the skill in your question.

## Connect and test the skill

Connect your agent to the DualEntry MCP server once, then check that the skill answers from your records. The skill gives your agent instructions, and the connection lets it read your records.

1. Connect the agent to DualEntry, signing in as the user whose access you want the agent to have.
   * **Claude**: See [How to Connect Claude from the Connector Directory](https://docs.dualentry.com/accountants/ai-automation/mcp/connect-claude-from-the-connector-directory.md).
   * **Cursor, VS Code, Codex, and other clients**: See [Connect MCP Clients](https://docs.dualentry.com/accountants/ai-automation/mcp/mcp-quickstart.md).
2. Ask a question the skill covers. Each skill's example prompt works well, such as "Which bills are due in the next 10 days?"
3. Check the answer. It should cite DualEntry records, such as bill or invoice numbers, and follow the skill's defaults, such as the date window and sort order.

If the answer doesn't cite records, the agent is likely answering without DualEntry data. Check that the connection appears under **Connected Apps** on your **Security** settings page in DualEntry, with a recent last-used date. See [Connected Apps](https://docs.dualentry.com/accountants/ai-automation/mcp/mcp-integration.md#connected-apps).

## Update or remove a skill

A copied skill doesn't update itself, so you replace it when the catalog changes. The catalog on [dualentry.com/skills](https://www.dualentry.com/skills) always shows the current version of each skill.

To update a skill, copy its definition from the catalog again and replace the text in your `SKILL.md`. In Claude on the web or desktop, upload the new ZIP file in place of the old skill. Then restart the agent or start a new conversation, so it reads the new version.

To remove a skill, delete its folder from your agent's skills directory, or remove it under **Customize > Skills** in Claude. Removing a skill doesn't change your MCP connection, so the agent can still read DualEntry when you ask it to directly.

To cut off the agent's access to DualEntry entirely, revoke its connection under **Connected Apps** on your **Security** settings page. The agent loses access on its next call, whether or not it still has skills installed.

## Troubleshooting

These are the common problems when you install a skill and first use it.

| What you see | What to do |
| - | - |
| The skill doesn't appear in your agent | Check that the file is named `SKILL.md` and sits inside a folder with the skill's name. Then restart the agent. |
| Claude rejects the upload | Upload a ZIP file that contains the skill's folder, not the `SKILL.md` file on its own. |
| The agent answers without using the skill | Start a new conversation and ask a question close to the skill's example prompt. |
| The agent says it can't reach DualEntry | The agent isn't connected to the MCP server. Connect it as described in [Connect and test the skill](#connect-and-test-the-skill). |
| Calls fail after working before | In DualEntry, check **Connected Apps** on your **Security** settings page. If the connection shows **Needs reconnect** or was revoked, connect the agent again. |
| The agent says the connection is waiting for your admin to approve it | Your organization requires admin approval for AI apps. Ask an administrator to approve the connection on the **Connected Apps** tab of Organization Settings, then ask your question again. |

## Related reading

* [Accounting Skills: DualEntry Skills for AI Agents](https://docs.dualentry.com/accountants/ai-automation/mcp/accounting-skills.md)
* [DualEntry MCP](./index)
* [Connect MCP Clients](https://docs.dualentry.com/accountants/ai-automation/mcp/mcp-quickstart.md)
* [How to Connect Claude from the Connector Directory](https://docs.dualentry.com/accountants/ai-automation/mcp/connect-claude-from-the-connector-directory.md)
* [MCP Server: Tools, Permissions, and Troubleshooting](https://docs.dualentry.com/accountants/ai-automation/mcp/mcp-integration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.