SkillCodex

Bộ skill tổng quát cho Codex CLI/IDE, port từ skillclaude và chuẩn hóa theo cấu trúc Codex Skills.

Repo này dùng để triển khai cùng một bộ kỹ năng vào nhiều workspace. Bạn có thể cài global cho mọi project, hoặc cài project-level vào từng workspace để commit cùng team.

Cài nhanh

Global, dùng ở mọi workspace

git clone https://github.com/saodonga/skillcodex.git ~/skillcodex
cd ~/skillcodex
bash scripts/install.sh --global

Lệnh trên copy toàn bộ skill vào:

~/.codex/skills/

Project-level, dùng cho workspace hiện tại

git clone https://github.com/saodonga/skillcodex.git /tmp/skillcodex
cd /path/to/your/workspace
bash /tmp/skillcodex/scripts/install.sh --project .

Lệnh trên copy skill vào:

.codex/skills/

Đây là cách phù hợp khi muốn mỗi workspace tự mang theo bộ skill riêng.

Cài chọn lọc

bash scripts/install.sh --global karpathy-guidelines git-workflow code-review security-review
bash scripts/install.sh --project /path/to/workspace vietnamese-writer product-docs

Danh sách skill

Skill	Công dụng chính
karpathy-guidelines	Nguyên tắc coding thận trọng: hiểu trước khi sửa, đơn giản, kiểm chứng được
git-workflow	Git workflow, branch, commit, PR, changelog, remote/security
code-review	Review code có severity, tập trung correctness/security/performance
security-review	Audit bảo mật theo OWASP, auth, injection, crypto, secrets
ai-engineer	LLM apps, RAG, agents, vector search, prompt/model integration
data-analysis	Phân tích CSV/Excel/JSON, thống kê, biểu đồ, insight
auth-rbac	Google OAuth, SQL-backed RBAC, protected routes, role/permission
ui-ux-design	UI/UX, visual quality, accessibility, responsive, design systems
vietnamese-writer	Viết/chỉnh tiếng Việt tự nhiên, đúng văn phong
email-ops	Quy trình triage, draft, summarize email với connector phù hợp
product-docs	PRD, user guide, release notes, đồng bộ docs khi feature đổi
session-logger	Nhật ký phiên làm việc lưu trong {project}/sessions/
continuous-learning	Rút pattern từ session để tạo/cập nhật skill tái sử dụng

Cấu trúc

skillcodex/
├── README.md
├── INSTALL.md
├── skills/
│   └── <skill-name>/
│       ├── SKILL.md
│       ├── references/
│       ├── scripts/
│       └── templates/
└── scripts/
    ├── install.sh
    └── validate.sh

Mỗi skill có SKILL.md với YAML frontmatter chỉ gồm name và description, đúng cơ chế trigger của Codex. Các file references/, scripts/, templates/ được giữ để Codex chỉ đọc khi cần.

Gợi ý dùng trong workspace

• Nếu bạn làm một repo riêng lẻ: cài vào .codex/skills/ của repo đó.
• Nếu bạn làm nhiều repo cùng phong cách: cài global vào ~/.codex/skills/.
• Nếu team cùng dùng Codex: commit .codex/skills/ vào repo team để mọi người dùng chung quy trình.

Nguồn

Port từ bộ skillclaude của saodonga, đã chỉnh để phù hợp Codex:

• ~/.claude/skills -> ~/.codex/skills
• Claude-specific agents/hooks không port trực tiếp
• Frontmatter chuẩn hóa cho Codex
• Một số nội dung model/API được chuyển sang hướng dẫn kiểm tra tài liệu chính thức

License

MIT