add-xo-skill

CLI tool để thêm skills vào các dự án AI agent (Antigravity, Claude).

Cài đặt

# Sử dụng trực tiếp với npx
npx add-xo-skill

# Hoặc cài đặt global
pnpm add -g add-xo-skill

Sử dụng

Interactive Mode (Khuyến nghị)

Chạy lệnh không tham số để sử dụng interactive prompts:

npx add-xo-skill

CLI sẽ hỏi bạn:

1. Chọn agent type (Antigravity hoặc Claude)
2. Chọn skill cần thêm
3. Xác nhận trước khi copy

Command Line Mode

Bạn cũng có thể chỉ định trực tiếp:

# Thêm skill với options
npx add-xo-skill add --agent antigravity --skill example-skill

# Hoặc dùng short flags
npx add-xo-skill add -a claude -s my-skill

Cách hoạt động

1. Tìm skills: CLI chứa một thư mục skills/ với các skill templates
2. Copy .md files: Chỉ copy các file .md từ skill (không copy toàn bộ thư mục)
3. Transform: Có thể chỉnh sửa nội dung file trước khi copy (xem src/utils/transform.ts)
4. Target directory:
   • Antigravity → .agent/skills/
   • Claude → .claude/skills/

Cấu trúc Skill

Mỗi skill trong thư mục skills/ nên có cấu trúc:

my-skill/
├── SKILL.md          # Main skill documentation (required)
├── reference.md      # Additional reference (optional)
└── examples.md       # Examples (optional)

File SKILL.md nên có frontmatter:

---
name: My Skill
description: Short description of the skill
category: category-name
---

# My Skill

Skill content here...

Development

Setup

# Clone repo
git clone <repo-url>
cd add-xo-skill

# Install dependencies
pnpm install

# Build
pnpm build

Testing Locally

# Link CLI locally
pnpm link --global

# Test in another project
cd /path/to/test-project
add-skill

Adding New Skills

1. Tạo thư mục mới trong skills/
2. Thêm SKILL.md và các file .md khác
3. Build lại: pnpm build

Customizing Transformations

Chỉnh sửa src/utils/transform.ts để thay đổi cách xử lý file .md trước khi copy:

export const defaultTransform: TransformFunction = async (content, filePath) => {
  // Your custom transformations here
  return content;
};

Publishing to npm

# Build
pnpm build

# Login to npm (nếu chưa)
npm login

# Publish (scoped package cần --access public)
npm publish --access public

License

MIT