Hướng dẫn đóng góp cho awesome-claude (HeyClaude)
Skill hướng dẫn Claude tạo PR đúng chuẩn cho repo awesome-claude (HeyClaude), phân biệt luồng review nội dung và luồng code.
Lập trìnhTrung cấp★ 291⑂ 119Điểm AI 8/10Cập nhật lần cuối: 31 thg 7, 2026
Làm được gì
Đây là bộ quy tắc để Claude đóng góp đúng cách vào repo JSONbored/awesome-claude (HeyClaude).
- Xác định loại đóng góp: PR nội dung cộng đồng (đúng một file
content/<category>/<slug>.mdx) hay PR nền tảng/code (web, registry, MCP, scripts). - Giải thích ai quyết định: PR nội dung do "HeyClaude submission gate" riêng tư xét một lần; PR code chỉ được bot gittensory-orb góp ý, quyền merge thuộc CI + maintainer.
- Danh sách điều cấm: không sửa file sinh tự động (
README.md,apps/web/public/data/**,apps/web/src/generated/**,routeTree.gen.ts), không xin host file ZIP/MCPB, không farming issue/PR bằng nhiều tài khoản. - Kiểm thử vừa đủ: PR nội dung chỉ cần
pnpm validate:content:strict; PR code cần đạt Codecov patch 70%. - Tránh nhầm lẫn: repo này KHÔNG bắt buộc linked issue, khác với gittensory/metagraphed.
Phù hợp với ai
- Người muốn đăng agent, MCP server, skill, hook của mình lên thư mục HeyClaude
- Lập trình viên sửa lỗi cho website hoặc package của repo
- Ai muốn tránh bị từ chối PR vì lỗi hình thức
Ví dụ sử dụng
- "Tạo PR đăng MCP server của tôi lên HeyClaude" → skill đọc schema, viết đúng một file .mdx, điền
safetyNotes/privacyNotes, rồi chạy lệnh validate. - "Sửa bug trên website awesome-claude" → tìm đoạn code tương tự làm mẫu, chỉ chạy test cho phần đã đổi, bổ sung test để đạt 70% coverage.
- "Có nên cập nhật README kèm PR nội dung không?" → skill cảnh báo đó là file sinh tự động và sẽ bị từ chối.
· · · 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/JSONbored/awesome-claude/HEAD/.claude/skills/contributing-to-awesome-claude/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.
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 .claude/skills/contributing-to-awesome-claude từ repo GitHub JSONbored/awesome-claude vào ~/.claude/skills/contributing-to-awesome-claude/ 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/JSONbored/awesome-claude.git /tmp/awesome-claude && mkdir -p ~/.claude/skills && cp -r /tmp/awesome-claude/.claude/skills/contributing-to-awesome-claude ~/.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/JSONbored/awesome-claude.git /tmp/awesome-claude - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Sao chép skill (nhớ kèm cả
reference.md):cp -r /tmp/awesome-claude/.claude/skills/contributing-to-awesome-claude ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/contributing-to-awesome-claudephải thấySKILL.mdvàreference.md. - Khởi động lại Claude Code và thử nói: "Tôi muốn gửi entry lên awesome-claude".
- Cần cài sẵn pnpm để chạy được các lệnh kiểm tra.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT