Skip to main content
GitHits ships four coordinated Skills:
  • githits-onboarding guides setup and sign-in.
  • githits-mcp routes public OSS research through MCP tools and embeds the stable quick-start guide.
  • githits-code uses equivalent CLI commands when MCP tools are unavailable.
  • githits-package uses package CLI commands when MCP tools are unavailable.
Guided npx githits@latest init installs these Skills alongside MCP by default. The Skills detect the available surface and avoid duplicate MCP and CLI calls. Before you use Skills, make sure the GitHits CLI works in the same environment as your agent:
For a Skills-only setup, choose Install Agent Skills instead during interactive init. You can also install the Skills directly:
During installation, choose which harnesses to install the Skills into. You can also choose whether to install them at user level or project level. Do not run the direct Skills installer on top of a guided init installation. Guided setup already installs and repairs the same four skill directories.

​
When to use Skills

Use Skills-only mode when your coding harness has strong Skills support and you prefer instruction-driven CLI workflows over MCP tools. Use guided MCP setup when you want your agent to call GitHits tools directly. This is the default path. The installed githits-mcp skill supplies routing and safety context, while the CLI-backed skills remain fallbacks.

​
Relationship to MCP

The packaged Skills coordinate with the MCP server:
  • When GitHits MCP tools are available, githits-mcp tells the agent to use them.
  • When MCP tools are unavailable but the CLI works, githits-code and githits-package provide equivalent command workflows.
  • A current githits-mcp skill embeds the stable guide, so the agent normally skips the quick_start MCP call.
To switch from MCP to Skills:
  1. Run npx githits@latest uninstall --keep-guidance, or disable the GitHits MCP server for that harness.
  2. Confirm the GitHits CLI works with npx githits@latest auth status.
  3. If you did not keep the packaged guidance, install the Skills with npx skills add githits-com/githits-cli.
  4. Start a new harness session so it loads the updated instructions.