How to use the Repomix Website Maintainer agent skill

What is an agent skill, and what does this one do?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent reads when a task matches the skill's description. This one is named website-maintainer and its description says to use it when working on the Repomix documentation website in the website/ directory, including VitePress configuration, multi-language content, or translation workflows.

Once installed, the agent knows where the VitePress config files live, how the 14 language folders are organised, and how to add a new language or edit guide pages and sidebars. It also follows the stated translation rules: English is the source of truth, and code examples and CLI options stay unchanged.

• Knows the layout: config.ts, the config/ folder with configShard.ts and per-language config files, and src/[lang]/ content folders.
• Explains the steps for adding a new language.
• Shows where to edit guide documents, sidebars and navigation, and shared settings such as logo and footer.
• Applies the translation guidelines: translate UI labels in the config file, keep code and CLI options as they are.

Install the website-maintainer skill

Download the ZIP of the skill from this page and unzip it. The skill folder contains a single file, SKILL.md. Put the unzipped folder in one of these locations:

For all your projects, place it in ~/.claude/skills/. For one project only, place it in that project's .claude/skills/ folder.

You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/website-maintainer/
• Project install: .claude/skills/website-maintainer/ inside your project
• Claude apps: Settings → Capabilities → Skills, then upload the skill

How do you trigger the skill with a natural request?

You do not need a special command. The agent loads the skill when your request matches its description, so mention the Repomix docs site, the website/ directory, VitePress, a language, or translation work in plain words.

Be specific about the file or task. The skill covers configuration, content editing and translation, so a request that names one of those areas is most likely to match.

• "In the Repomix website, add a sidebar link for a new installation page."
• "Add Korean to the VitePress locales for the Repomix docs and create the src folder."
• "Translate the installation guide in src/en/guide into German, keeping code blocks and CLI options unchanged."
• "Where is the search config for the Japanese docs?"

What does the skill need, and does it run anything?

The skill lists no requirements. It does not run scripts and does not use the network. The file contains guidance only, so it does not add tools, run builds or deploy the site. The agent still works on your files with whatever permissions your setup gives it, so review its changes as you would any other edit.

Because the paths and rules are specific to Repomix, the skill is less useful for unrelated websites. It can lead an agent to apply Repomix file names where they do not exist.

• Requirements: none listed
• Runs scripts: no
• Uses network: no
• Files included: SKILL.md

What is the structure the skill describes?

The skill maps the documentation site under website/client/. The main config is .vitepress/config.ts, which imports all locales. Shared settings such as PWA and sitemap live in .vitepress/config/configShard.ts, and each language has a config[Lang].ts file for its nav, sidebar and search. Content sits in src/[lang]/ for the 14 languages: en, ja, zh-cn, zh-tw, ko, de, fr, es, pt-br, id, vi, hi, it and ru.

Examples of common tasks

For a new language, the skill lists four steps: create config/configXx.ts based on an existing one, import it and add it to locales in config.ts, add its search config to configShard.ts, and create src/xx/ with content copied from en/.

For a content fix, the skill points to src/[lang]/guide/*.md, for example src/ja/guide/installation.md. For a navigation change, it points to themeConfig.sidebar in the relevant config[Lang].ts file.

• Add a language: follow the four steps above, then ask the agent to check each file.
• Fix a guide page: edit src/[lang]/guide/*.md in the language you need.
• Change the sidebar: edit themeConfig.sidebar in config/config[Lang].ts.
• Change the logo or footer: edit configShard.ts.

Tips for getting good results

Give the agent the language code and the file you want changed. The skill's layout is specific, so precise paths produce better results than general requests.

When translating, ask the agent to keep code blocks and CLI options unchanged and to translate only UI labels in the config file. Check the English source first, since the skill treats English as the source of truth.

• Name the language code, for example zh-tw or pt-br.
• State the file path, for example src/de/guide/installation.md.
• Ask for a check of changed files against the English versions.