https://github.com/mehmetbaykar/claude-code-docs-skill
https://github.com/mehmetbaykar/claude-code-docs-skill
claude-code skills
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/mehmetbaykar/claude-code-docs-skill
- Owner: mehmetbaykar
- License: other
- Created: 2026-05-15T23:01:24.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-18T19:49:05.000Z (about 1 month ago)
- Last Synced: 2026-05-18T21:55:23.588Z (about 1 month ago)
- Topics: claude-code, skills
- Language: Python
- Homepage:
- Size: 1.06 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Code Docs Skill
Local Agent Skill mirror of the Anthropic Claude Code documentation from
[https://code.claude.com/docs/en/](https://code.claude.com/docs/en/).
The installable skill lives in `skills/claude-code-docs/`: `SKILL.md` is the
entry point, cleaned Markdown copies of every relevant Claude Code page live
under `skills/claude-code-docs/references/`, and a 3-hour GitHub Action keeps
them in sync with upstream.
## Install
```bash
npx skills add mehmetbaykar/claude-code-docs-skill
```
The `npx skills` CLI discovers the nested skill automatically. Installing the
repo exposes only the skill directory (`SKILL.md`, provider metadata in
`agents/`, and `references/`) to the target agent while repository maintenance
files stay at the repo root.
## Usage
Once installed, invoke the skill with a topic from your agent
(`$claude-code-docs hooks` in Codex, `/claude-code-docs hooks` in Claude Code)
or with no argument to list topics. The full agent-facing usage contract lives
in [skills/claude-code-docs/SKILL.md](skills/claude-code-docs/SKILL.md).
## What's mirrored
The fetcher reads the Claude Code sitemap at
`https://code.claude.com/docs/sitemap.xml`, keeps every English documentation
URL whose path starts with `/docs/en/`, and excludes defensive non-core
subtrees:
- `/docs/en/tool-use/*`
- `/docs/en/examples/*`
- `/docs/en/legacy/*`
- `/docs/en/api/*`
- `/docs/en/reference/*`
The mirror contains 132 cleaned Markdown files plus
`skills/claude-code-docs/references/INDEX.md` and
`skills/claude-code-docs/references/docs_manifest.json`. Any sitemap entries we
intentionally skip are recorded in `docs_manifest.json` under `skipped`.
## Update
```bash
npx skills update claude-code-docs-skill # update an installed local copy
```
Upstream refreshes happen automatically every 3 hours; there is nothing to
configure on the consumer side.
## Refresh locally (maintainers only)
```bash
python3 -m venv .venv
.venv/bin/python -m pip install -r scripts/requirements.txt
.venv/bin/python scripts/fetch_claude_code_docs.py
```
The fetcher reads the sitemap, downloads each page's `.md` source, cleans MDX
and JSX wrappers into plain Markdown, and rewrites
`skills/claude-code-docs/references/INDEX.md` and
`skills/claude-code-docs/references/docs_manifest.json`. Files whose content
hash is unchanged are not rewritten.
## Repository layout
```text
.
├── skills/
│ └── claude-code-docs/
│ ├── agents/
│ │ └── openai.yaml # Agent UI metadata + invocation policy
│ ├── SKILL.md # installed skill instructions and routing
│ └── references/ # mirrored docs + INDEX + manifest
├── scripts/
│ ├── fetch_claude_code_docs.py # sitemap -> fetch -> clean -> write
│ └── requirements.txt
└── .github/workflows/
└── update-docs.yml # cron every 3 hours
```
## Troubleshooting
- If docs look stale, check the latest run of
[Update Claude Code Documentation](../../actions/workflows/update-docs.yml) on
this repository and reproduce locally with the steps in "Refresh locally" above.
- If the scheduled fetch fails, the workflow opens or updates an issue
automatically.
- If a single page renders poorly, the upstream MDX is preserved under
`skills/claude-code-docs/references/_raw/` whenever the cleaner falls back, so
the source of truth is never lost.
## Notes
This repository is an unofficial local mirror packaged as an Agent Skill. It is
not affiliated with, endorsed by, or sponsored by Anthropic.
Documentation content belongs to Anthropic and is subject to Anthropic's
applicable terms and policies. The MIT license in this repository applies only
to the mirroring tool, scripts, skill metadata, and repository-specific code.