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

Tài liệu tham chiếu Plugin Claude Code (bản night-market)

Tài liệu tham chiếu chi tiết về cách manifest, skill, command, agent và hook của Claude Code hoạt động, dùng khi viết hoặc gỡ lỗi plugin.

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

Làm được gì

Tổng hợp toàn bộ "hợp đồng kỹ thuật" cần biết khi tự viết hoặc debug plugin cho Claude Code:

  • Ý nghĩa từng field của .claude-plugin/plugin.json, metadata.json, openpackage.yml
  • Quy ước frontmatter của SKILL.md (description tối đa 160 ký tự, phân loại role, nạp lũy tiến hub–spoke)
  • Bảng quyết định: khi nào viết command, khi nào viết skill, khi nào viết agent; cách dùng $ARGUMENTS và extends
  • Phần hook: chỉ đăng ký trong hooks/hooks.json, payload đến qua stdin JSON (không phải biến môi trường), luôn exit 0 và trả verdict JSON qua stdout, PreToolUse chỉ nhận allow|deny|ask
  • Ràng buộc Python 3.9 của trình thông dịch hệ thống (cấm datetime.UTC, bắt buộc from __future__ import annotations, phải bọc import thư viện ngoài) và việc plugin chạy từ cache nên không dùng đường dẫn tương đối
  • Cơ chế marketplace, khóa phiên bản đồng bộ và bộ lệnh shell để tự kiểm chứng lại mọi thông tin

Dành cho ai

  • Lập trình viên đang xây plugin/skill/hook cho Claude Code
  • Người phải truy vết một hook "chạy mà không làm gì"
  • Nhóm muốn dựng hệ plugin nội bộ theo mô hình của repo claude-night-market

Ví dụ sử dụng

  1. Hook không phản hồi: phát hiện script đang đọc CLAUDE_TOOL_INPUT, sửa sang đọc JSON từ stdin và kiểm tra echo not-json | python3 hook.py; echo $? trả về 0.
  2. Lỗi "Duplicate hooks file" khi mở session: xóa ./hooks/hooks.json khỏi mảng hooks trong plugin.json, để Claude Code tự nạp.
  3. Thêm skill mới: kiểm tra skill đã có trong mảng skills của plugin.json, description dưới 160 ký tự và có mục ## Exit Criteria để vượt các script ratchet.

· · · 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 /tmp/claude-night-market && mkdir -p ~/.claude/skills && cp -r /tmp/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 đến thư mục làm việc tạm.
  2. Tải repo: git clone https://github.com/athola/claude-night-market.git
  3. Tạo thư mục skill nếu chưa có: mkdir -p ~/.claude/skills
  4. Sao chép skill: cp -r claude-night-market/.claude/skills/claude-code-plugin-reference ~/.claude/skills/
  5. Khởi động lại Claude Code, rồi thử hỏi: "hợp đồng payload của hook là gì?" để skill được nạp.
  6. (Tùy chọn) Giữ lại repo đã clone vì tài liệu thường trích dẫn các tệp trong plugins/....
  7. (Tùy chọn) Muốn dùng chính các plugin của repo, chạy /plugin marketplace add athola/claude-night-market trong Claude Code.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT