Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
← Về danh sách

Tham chiếu Plugin Claude Code (bản night-market)

Tài liệu tham chiếu cho người viết plugin: hợp đồng thực tế của plugin, skill, command, agent và hook trong Claude Code.

Lập trìnhNâng cao★ 339⑂ 36Điểm AI 8/10Cập nhật lần cuối: 24 thg 9, 2026

Làm được gì

  • Bảng giải thích từng trường của plugin.json, metadata.json, openpackage.yml và marketplace.json.
  • Hợp đồng frontmatter của SKILL.md: giới hạn 160 ký tự cho description, phân loại role, mô hình nạp dần hub-and-spoke.
  • Cơ chế hook: chỉ đăng ký trong hooks/hooks.json, đọc payload từ stdin JSON (không phải biến môi trường), định dạng verdict theo từng event, ngân sách timeout, chạy từ plugin cache.
  • Ràng buộc Python 3.9 cho script hook và cách viết thay thế (timezone.utc thay cho datetime.UTC, import có guard).
  • Danh sách lệnh shell để tự kiểm chứng lại các dữ kiện dễ lỗi thời, kèm checklist Exit Criteria.

Dành cho ai

  • Lập trình viên tự viết hoặc debug plugin/skill cho Claude Code.
  • Người gặp hook "im lặng không chạy" và cần biết nguyên nhân điển hình.
  • Người đóng góp cho repo claude-night-market (nhiều quy ước chỉ áp dụng cho repo này).

Ví dụ sử dụng

  1. Hook PreToolUse không chặn được lệnh: kiểm tra có đọc stdin JSON và có in đúng permissionDecision là allow/deny/ask.
  2. Thêm skill mới: soát lại đã có trong mảng skills của plugin.json, description ≤160 ký tự, có mục ## Exit Criteria.
  3. Hook gọi subprocess: viết test khẳng định timeout nội bộ nhỏ hơn timeout đăng ký trong hooks.json.

· · · 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/athola/claude-night-market/HEAD/.claude/skills/claude-code-plugin-reference/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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. 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 .claude/skills/claude-code-plugin-reference từ repo GitHub athola/claude-night-market vào ~/.claude/skills/claude-code-plugin-reference/ 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/athola/claude-night-market.git && mkdir -p ~/.claude/skills && cp -r claude-night-market/.claude/skills/claude-code-plugin-reference ~/.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.

  1. Mở terminal và chuyển tới thư mục bạn muốn lưu mã nguồn.
  2. Clone repo: git clone https://github.com/athola/claude-night-market.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Copy skill: cp -r claude-night-market/.claude/skills/claude-code-plugin-reference ~/.claude/skills/
  5. Khởi động lại Claude Code, rồi hỏi ví dụ: "Tôi cần viết hook cho plugin, quy tắc là gì?" để skill được nạp.
  6. (Tùy chọn) Muốn chạy các lệnh kiểm chứng trong tài liệu, hãy chạy từ thư mục gốc repo vừa clone.