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

# GitHits CLI Skills setup

> Install GitHits Skills when you prefer a Skills workflow that calls the GitHits CLI instead of MCP tools.

If you do not want to use MCP, you can use GitHits through the provided Skills. The Skills are CLI-backed: they tell your agent when and how to run `npx githits@latest` commands.

Before you use Skills, make sure the GitHits CLI works in the same environment as your agent:

```bash theme={null}
npx githits@latest auth status
```

Then install the Skills:

```bash theme={null}
npx skills add githits-com/githits-cli
```

During installation, choose which harnesses to install the Skills into. You can also choose whether to install them at user level or project level.

<Warning>
  Do not use the GitHits Skills and the GitHits MCP server in the same harness at the same time. They expose overlapping capabilities, so using both usually creates duplicate instructions and confusing tool choices for the agent.
</Warning>

## When to use Skills

Use Skills when your coding harness has strong Skills support and you prefer instruction-driven CLI workflows over MCP tools.

Use the MCP server when you want your agent to call GitHits tools directly through MCP. For most users, the MCP setup from `npx githits@latest init` is the default path.

## Relationship to MCP

Skills are complementary to the MCP server. If you already use the MCP server, you usually do not need to install the Skills.

To switch from MCP to Skills:

1. Remove or disable the GitHits MCP server from that harness.
2. Confirm the GitHits CLI works with `npx githits@latest auth status`.
3. Install the Skills with `npx skills add githits-com/githits-cli`.
4. Restart the harness so it loads the new instructions.