Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 0 additions & 55 deletions .claude/agents/browser-extension-developer.md

This file was deleted.

71 changes: 0 additions & 71 deletions .claude/agents/lint-fixer.md

This file was deleted.

49 changes: 0 additions & 49 deletions .claude/agents/website-maintainer.md

This file was deleted.

36 changes: 36 additions & 0 deletions .claude/skills/browser-extension-developer/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
name: browser-extension-developer
description: Use this skill when developing or maintaining browser extension code in the `browser/` directory, including Chrome/Firefox/Edge compatibility, content scripts, background scripts, or i18n updates.
---

# Browser Extension Developer

Cross-browser extension (Chrome/Firefox/Edge) using **WXT framework** with Manifest V3. Injects "Repomix" button into GitHub repository pages.

## Structure

```plaintext
browser/
├── entrypoints/ # background.ts, content.ts
├── public/_locales/ # i18n (12 languages)
├── wxt.config.ts # WXT configuration
└── .output/ # Built files (chrome-mv3, firefox-mv2)
```

## Commands

- `npm run dev` - Development mode (Chrome default)
- `npm run dev:firefox` - Firefox dev mode
- `npm run build-all` - Build all browsers
- `npm run lint` / `npm run test`

## i18n

12 languages: en, ja, de, fr, es, pt_BR, id, vi, ko, zh_CN, zh_TW, hi
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The language count is accurate - there are indeed 12 language directories. This appears correct based on the actual directory listing: en, ja, de, fr, es, pt_BR, id, vi, ko, zh_CN, zh_TW, hi


New language: Create `public/_locales/[code]/messages.json` with keys: appDescription, openWithRepomix

## Notes

- Chrome/Edge use `chrome.*` APIs, Firefox may need polyfills
- Run lint and tests before completion
38 changes: 38 additions & 0 deletions .claude/skills/lint-fixer/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
name: lint-fixer
description: "Use this skill to run npm run lint and fix linting issues. Triggers on fixing lint errors after code changes or validating code against project style guidelines."
---

# Lint Fixer

Fix linting issues while preserving code functionality.

## Lint Tools

`npm run lint` runs 4 tools in sequence:

1. **Biome** (`biome check --write`) - Formatter + linter, auto-fixes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo in tool name: "tsgo" should be "tsc" (TypeScript Compiler):

Suggested change
1. **Biome** (`biome check --write`) - Formatter + linter, auto-fixes
3. **tsc** (`tsc --noEmit`) - TypeScript type checking

The TypeScript compiler command is tsc, not tsgo.

2. **oxlint** (`oxlint --fix`) - Fast JS/TS linter, auto-fixes
3. **tsgo** (`tsgo --noEmit`) - TypeScript type checking
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tool name "tsgo" is correct. Looking at the package.json, the command is indeed tsgo --noEmit (not tsc). "tsgo" appears to be a TypeScript runner/checker tool used by this project.

4. **secretlint** - Detects secrets/credentials

## Workflow

1. Run `npm run lint` to identify issues
2. Review errors by category (type errors vs style vs secrets)
3. Fix issues - Biome/oxlint auto-fix most style issues
4. Run `npm run lint` again to verify
5. Run `npm run test` to ensure no breakage

## Config Files

- `biome.json` - Formatting rules (2 spaces, 120 chars, single quotes)
- `.oxlintrc.json` - JS/TS lint rules
- `.secretlintrc.json` - Secret detection rules

## Key Points

- Biome/oxlint auto-fix most issues; review changes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consistency issue: Same typo "tsgo" appears here:

Suggested change
- Biome/oxlint auto-fix most issues; review changes
- Type errors (tsc) require manual fixes

- Type errors (tsgo) require manual fixes
- Never change code behavior when fixing lint
- Keep files under 250 lines
40 changes: 40 additions & 0 deletions .claude/skills/website-maintainer/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
name: website-maintainer
description: Use this skill when working on the Repomix documentation website in `website/` directory, including VitePress configuration, multi-language content, or translation workflows.
---

# Website Maintainer

VitePress documentation site with 12 languages.

## Structure

```plaintext
website/client/
├── .vitepress/
│ ├── config.ts # Main config (imports all locales)
│ └── config/
│ ├── configShard.ts # Shared settings (PWA, sitemap, etc.)
│ └── config[Lang].ts # Per-language config (nav, sidebar, search)
└── src/
└── [lang]/ # en, ja, zh-cn, zh-tw, ko, de, fr, es, pt-br, id, vi, hi
```

## Adding New Language

1. Create `config/configXx.ts` based on existing (exports config + search translations)
2. Import and add to `locales` in `config.ts`
3. Add search config to `configShard.ts`
4. Create `src/xx/` directory with content (copy from `en/`)

## Editing Content

- **Documents**: Edit `src/[lang]/guide/*.md` (e.g., `src/ja/guide/installation.md`)
- **Navigation/Sidebar**: Edit `config/config[Lang].ts` → `themeConfig.sidebar`
- **Shared settings** (logo, footer): Edit `configShard.ts`

## Translation Guidelines

- English (`src/en/`) is source of truth
- Keep code examples and CLI options unchanged
- Translate UI labels in config file (nav, sidebar, search modal)
Loading