Trình kiểm tra Agent & Skill

Skill lint tự động kiểm tra frontmatter, quy tắc đặt tên và nội dung của các file agent/skill trong Claude Code để tránh lỗi âm thầm khi chạy.

Lập trìnhTrung cấp★ 535⑂ 44Điểm AI 8/10Cập nhật lần cuối: 8 thg 8, 2026

Làm được gì

Kiểm tra frontmatter của agents/*.md và skills/*/SKILL.md: có name không, name có trùng tên file/thư mục không, đúng kebab-case chưa, description dài 20–200 ký tự, tools phải là mảng, model chỉ nhận opus/sonnet
Kiểm tra phần thân: có system prompt không, cảnh báo file quá ngắn (<50 dòng) hoặc quá dài (>2000 dòng), yêu cầu ít nhất một tiêu đề ##, kiểm tra có code block
Phân loại lỗi theo ba mức ERROR / WARN / INFO để biết cái nào phải sửa ngay
Cung cấp sẵn script bash và workflow GitHub Actions chạy lint trên mỗi pull request
Bảng các lỗi thường gặp kèm cách khắc phục (tên không khớp file, tools: Read, Bash sai định dạng, trùng name...)

Phù hợp với ai

Lập trình viên quản lý nhiều agent/skill Claude Code cho cá nhân hoặc công ty
Nhóm chia sẻ repo skill và muốn có cổng kiểm duyệt chất lượng cho PR
Người từng gặp cảnh "đã tạo skill mà Claude không bao giờ gọi tới"

Ví dụ sử dụng

Sau khi thêm agent mới code-reviewer.md, chạy lint và phát hiện ngay lỗi name: codeReviewer không khớp tên file
Quét toàn bộ repo: bash scripts/lint-agents.sh 2>&1 | tee lint-report.txt rồi lọc grep "^ERROR" để xem lỗi nghiêm trọng
Gắn vào GitHub Actions để mọi PR động tới agents/** hoặc skills/** đều được lint tự động trước khi merge

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/vibeeval/vibecosystem/HEAD/skills/agent-linter/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skills/agent-linter từ repo GitHub vibeeval/vibecosystem vào ~/.claude/skills/agent-linter/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/vibeeval/vibecosystem.git /tmp/vibecosystem && mkdir -p ~/.claude/skills && cp -r /tmp/vibecosystem/skills/agent-linter ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal.
Clone repo về thư mục tạm: git clone https://github.com/vibeeval/vibecosystem.git /tmp/vibecosystem
Tạo thư mục skills: mkdir -p ~/.claude/skills
Chép riêng skill này: cp -r /tmp/vibecosystem/skills/agent-linter ~/.claude/skills/
Khởi động lại Claude Code, thử yêu cầu "lint các file agent của tôi" để xác nhận skill đã nhận.
(Tùy chọn) Lưu đoạn script bash trong SKILL.md thành scripts/lint-agents.sh của dự án bạn và chỉnh lại đường dẫn agents/, skills/*/SKILL.md cho khớp cấu trúc repo.
(Tùy chọn) Thêm file YAML GitHub Actions trong tài liệu vào .github/workflows/lint-agents.yml để chạy lint tự động trên CI.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT