Tạo Agent Skills

Repomix có thể tạo đầu ra theo định dạng Claude Agent Skills, tạo một thư mục Skills có cấu trúc có thể được sử dụng làm tham chiếu codebase có thể tái sử dụng cho các trợ lý AI.

Tính năng này đặc biệt mạnh mẽ khi bạn muốn tham chiếu các triển khai từ các repository từ xa. Bằng cách tạo Skills từ các dự án mã nguồn mở, bạn có thể dễ dàng yêu cầu Claude tham chiếu các mẫu hoặc triển khai cụ thể trong khi làm việc trên code của riêng bạn.

Thay vì tạo một file đóng gói duy nhất, việc tạo Skills sẽ tạo một thư mục có cấu trúc với nhiều file tham chiếu được tối ưu hóa cho sự hiểu biết của AI và tìm kiếm tương thích grep.

NOTE

Đây là một tính năng thử nghiệm. Định dạng đầu ra và các tùy chọn có thể thay đổi trong các bản phát hành tương lai dựa trên phản hồi của người dùng.

Sử Dụng Cơ Bản

Tạo Skills từ thư mục cục bộ của bạn:

# Tạo Skills từ thư mục hiện tại
repomix --skill-generate

# Tạo với tên Skills tùy chỉnh
repomix --skill-generate my-project-reference

# Tạo từ thư mục cụ thể
repomix path/to/directory --skill-generate

# Tạo từ repository từ xa
repomix --remote https://github.com/user/repo --skill-generate

Chọn Vị Trí Lưu Skills

Khi bạn chạy lệnh, Repomix sẽ yêu cầu bạn chọn nơi lưu Skills:

1. Personal Skills (~/.claude/skills/) - Có sẵn trên tất cả các dự án trên máy của bạn
2. Project Skills (.claude/skills/) - Chia sẻ với nhóm của bạn qua git

Nếu thư mục Skills đã tồn tại, bạn sẽ được yêu cầu xác nhận ghi đè.

TIP

Khi tạo Project Skills, hãy cân nhắc thêm chúng vào .gitignore để tránh commit các file lớn:

.claude/skills/repomix-reference-*/

Cấu Trúc Được Tạo

Skills được tạo với cấu trúc sau:

.claude/skills/<skill-name>/
├── SKILL.md                    # Metadata chính và tài liệu Skills
└── references/
    ├── summary.md              # Mục đích, định dạng và thống kê
    ├── project-structure.md    # Cây thư mục với số dòng
    ├── files.md                # Tất cả nội dung file (tương thích grep)
    └── tech-stack.md           # Ngôn ngữ, framework, dependencies

Mô Tả File

SKILL.md

File Skills chính chứa:

• Tên Skills, mô tả và thông tin dự án
• Số lượng file, số dòng và số token
• Tổng quan về cách sử dụng Skills
• Vị trí file và giải thích định dạng
• Các trường hợp sử dụng phổ biến và mẹo

references/summary.md

Chứa:

• Mục đích: Giải thích đây là codebase tham chiếu cho AI sử dụng
• Cấu trúc File: Tài liệu nội dung của mỗi file tham chiếu
• Hướng dẫn Sử dụng: Cách sử dụng Skills hiệu quả
• Thống kê: Phân tích theo loại file, ngôn ngữ và file lớn nhất

references/project-structure.md

Cây thư mục với số dòng mỗi file để dễ dàng khám phá:

src/
  index.ts (42 lines)
  utils/
    helpers.ts (128 lines)
    math.ts (87 lines)

references/files.md

Tất cả nội dung file với header syntax highlighting, được tối ưu hóa cho tìm kiếm tương thích grep:

## File: src/index.ts
```typescript
import { sum } from './utils/helpers';

export function main() {
  console.log(sum(1, 2));
}
```

references/tech-stack.md

Tech stack được tự động phát hiện từ các file dependency:

• Ngôn ngữ: TypeScript, JavaScript, Python, v.v.
• Framework: React, Next.js, Express, Django, v.v.
• Phiên bản Runtime: Node.js, Python, Go, v.v.
• Package Manager: npm, pnpm, poetry, v.v.
• Dependencies: Tất cả dependency trực tiếp và dev
• File Cấu hình: Tất cả file cấu hình được phát hiện

Được phát hiện từ các file như: package.json, requirements.txt, Cargo.toml, go.mod, .nvmrc, pyproject.toml, v.v.

Tên Skills Tự Động Tạo

Nếu không cung cấp tên, Repomix tự động tạo một tên theo mẫu này:

repomix src/ --skill-generate                # → repomix-reference-src
repomix --remote user/repo --skill-generate  # → repomix-reference-repo
repomix --skill-generate CustomName          # → custom-name (chuẩn hóa thành kebab-case)

Tên Skills sẽ:

• Được chuyển đổi thành kebab-case (chữ thường, phân cách bằng dấu gạch ngang)
• Giới hạn tối đa 64 ký tự
• Được bảo vệ chống path traversal

Tích Hợp với Các Tùy Chọn Repomix

Việc tạo Skills tuân thủ tất cả các tùy chọn tiêu chuẩn của Repomix:

# Tạo Skills với lọc file
repomix --skill-generate --include "src/**/*.ts" --ignore "**/*.test.ts"

# Tạo Skills với nén
repomix --skill-generate --compress

# Tạo Skills từ repository từ xa
repomix --remote yamadashy/repomix --skill-generate

# Tạo Skills với các tùy chọn định dạng đầu ra cụ thể
repomix --skill-generate --remove-comments --remove-empty-lines

Skills Chỉ Tài Liệu

Sử dụng --include, bạn có thể tạo Skills chỉ chứa tài liệu từ một repository GitHub. Điều này hữu ích khi bạn muốn Claude tham chiếu tài liệu thư viện hoặc framework cụ thể trong khi làm việc trên code của bạn:

# Tài liệu Claude Code Action
repomix --remote https://github.com/anthropics/claude-code-action --include docs --skill-generate

# Tài liệu Vite
repomix --remote https://github.com/vitejs/vite --include docs --skill-generate

# Tài liệu React
repomix --remote https://github.com/reactjs/react.dev --include src/content --skill-generate

Hạn Chế

Tùy chọn --skill-generate không thể sử dụng với:

• --stdout - Đầu ra Skills yêu cầu ghi vào hệ thống file
• --copy - Đầu ra Skills là thư mục, không thể sao chép vào clipboard

Sử Dụng Skills Đã Tạo

Sau khi tạo, bạn có thể sử dụng Skills với Claude:

1. Claude Code: Skills tự động khả dụng nếu được lưu vào ~/.claude/skills/ hoặc .claude/skills/
2. Claude Web: Tải thư mục Skills lên Claude để phân tích codebase
3. Chia sẻ Nhóm: Commit .claude/skills/ vào repository của bạn để cả nhóm truy cập

Quy Trình Làm Việc Mẫu

Tạo Thư Viện Tham Chiếu Cá Nhân

# Clone và phân tích một dự án mã nguồn mở thú vị
repomix --remote facebook/react --skill-generate react-reference

# Skills được lưu vào ~/.claude/skills/react-reference/
# Bây giờ bạn có thể tham chiếu codebase của React trong bất kỳ cuộc hội thoại Claude nào

Tài Liệu Dự Án Nhóm

# Trong thư mục dự án của bạn
cd my-project

# Tạo Skills cho nhóm của bạn
repomix --skill-generate

# Chọn "Project Skills" khi được yêu cầu
# Skills được lưu vào .claude/skills/repomix-reference-my-project/

# Commit và chia sẻ với nhóm của bạn
git add .claude/skills/
git commit -m "Add codebase reference Skills"

Tài Nguyên Liên Quan

• Plugin Claude Code - Tìm hiểu về các plugin Repomix cho Claude Code
• MCP Server - Phương pháp tích hợp thay thế
• Nén Code - Giảm số token bằng nén
• Cấu hình - Tùy chỉnh hành vi Repomix