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

# Agent Skills

Install the public HolyDocs agent skills for Codex, Claude Code, Cursor, Windsurf, and other AI coding assistants.

## Overview

HolyDocs publishes a public skills repository for AI coding assistants that support `SKILL.md`-style workflows. These skills help assistants create HolyDocs projects, migrate docs from other platforms, and write cleaner documentation with the right structure and component patterns.

The canonical public repository is:

```text
https://github.com/seangeng/holydocs-skills
```

## Available Skills

**holydocs**

Create and configure HolyDocs docs projects, `docs.json`, navigation, themes, and MDX pages.
  **holydocs-migrate**

Migrate docs from Mintlify, GitBook, Docusaurus, ReadMe, or VuePress into HolyDocs.
  **holydocs-writing**

Improve doc quality with stronger structure, scannability, style, and component usage.

## Install with `npx skills`

Install the full skill set from GitHub:

```bash
npx skills add seangeng/holydocs-skills
```

Install an individual skill:

```bash
npx skills add seangeng/holydocs-skills --skill holydocs
npx skills add seangeng/holydocs-skills --skill holydocs-migrate
npx skills add seangeng/holydocs-skills --skill holydocs-writing
```

You can also inspect the repo before installing:

```bash
npx skills add seangeng/holydocs-skills --list
```

## When to Use Skills vs MCP

Use HolyDocs agent skills when you want a coding assistant to understand how to work with HolyDocs projects in general:

- creating a new HolyDocs docs site
- migrating from another docs platform
- improving or restructuring HolyDocs content in a repo

Use the [MCP Server](/mcp-server) when you want an assistant to read and search a specific deployed documentation project.

The public HolyDocs skills repo is separate from the generated `/skill.md` file that HolyDocs serves for each documentation site. The repo teaches assistants how to work with HolyDocs itself; `/skill.md` describes a specific docs site for agent discovery.

## Supported Agents

The public repo is designed for tools that support `SKILL.md` workflows, including Codex, Claude Code, Cursor, Windsurf, and similar AI coding assistants supported by the `skills` ecosystem.

## Related Links

- [Public skills repo](https://github.com/seangeng/holydocs-skills)
- [MCP Server](/mcp-server)
- [llms.txt](/llms-txt)