---
title: Tạo Agent Skills
description: Tạo Claude Agent Skills từ repository local hoặc remote để AI assistant có thể tái sử dụng tham chiếu codebase, cấu trúc dự án và mẫu triển khai.
---

# Tạo Agent Skills

Repomix có thể tạo đầu ra theo định dạng [Claude Agent Skills](https://docs.anthropic.com/en/docs/claude-code/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:

```bash
# 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:
> ```gitignore
> .claude/skills/repomix-reference-*/
> ```

## Sử Dụng Không Tương Tác

Đối với pipeline CI và script tự động hóa, bạn có thể bỏ qua tất cả các lời nhắc tương tác bằng `--skill-output` và `--force`:

```bash
# Chỉ định trực tiếp thư mục đầu ra (bỏ qua lời nhắc chọn vị trí)
repomix --skill-generate --skill-output ./my-skills

# Bỏ qua xác nhận ghi đè với --force
repomix --skill-generate --skill-output ./my-skills --force

# Ví dụ không tương tác đầy đủ
repomix --remote user/repo --skill-generate my-skill --skill-output ./output --force
```

| Tùy chọn | Mô tả |
| --- | --- |
| `--skill-output <path>` | Chỉ định trực tiếp đường dẫn thư mục đầu ra skill (bỏ qua lời nhắc vị trí) |
| `-f, --force` | Bỏ qua tất cả lời nhắc xác nhận (ví dụ: ghi đè thư mục skill) |

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

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

```text
.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-stacks.md           # Ngôn ngữ, framework, dependencies
```

### Mô Tả File

| File | Mục đích | Nội dung |
|------|----------|----------|
| `SKILL.md` | Metadata chính và tài liệu Skills | Tên Skills, mô tả, thông tin dự án, số lượng file/dòng/token, tổng quan sử dụng, các trường hợp sử dụng phổ biến và mẹo |
| `references/summary.md` | Mục đích, định dạng và thống kê | Giải thích codebase tham chiếu, tài liệu cấu trúc file, hướng dẫn sử dụng, phân tích theo loại file và ngôn ngữ |
| `references/project-structure.md` | Khám phá file | Cây thư mục với số dòng mỗi file |
| `references/files.md` | Tham chiếu code có thể tìm kiếm | Tất cả nội dung file với header syntax highlighting, tối ưu hóa cho tìm kiếm tương thích grep |
| `references/tech-stacks.md` | Tóm tắt tech stack | Ngôn ngữ, framework, phiên bản runtime, package manager, dependencies, file cấu hình |

#### Ví dụ: references/project-structure.md

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

#### Ví dụ: references/files.md

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

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

#### Ví dụ: references/tech-stacks.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:

```bash
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:

```bash
# 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:

```bash
# 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

```bash
# 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

```bash
# 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](/vi/guide/claude-code-plugins) - Tìm hiểu về các plugin Repomix cho Claude Code
- [MCP Server](/vi/guide/mcp-server) - Phương pháp tích hợp thay thế
- [Nén Code](/vi/guide/code-compress) - Giảm số token bằng nén
- [Cấu hình](/vi/guide/configuration) - Tùy chỉnh hành vi Repomix
