Kho skill dùng chung của #itsddvn

Kho các agent skill có thể tái sử dụng, do #itsddvn duy trì và chia sẻ.

Repository này là một catalog nhiều skill tương thích với Skills CLI mã nguồn mở. Mỗi skill nằm độc lập trong skills/<tên-skill>/ và có thể được cài riêng.

Public skills

Skill	Version	Description
idea-validator	3.0.0	Giúp đánh giá một ý tưởng có đáng thử hay không cho mục đích kinh doanh hoặc học tập, dựa trên bằng chứng, nguồn lực thực tế và một bước thử có giới hạn. Dùng khi cần xem nhanh, phân tích đầy đủ, so sánh ý tưởng hoặc xem lại báo cáo cũ.

Cài đặt

Cài idea-validator trực tiếp từ GitHub cho tất cả agent được hỗ trợ:

npx --yes skills@1.5.19 add itsddvn/skills-shared \
  --global \
  --skill idea-validator \
  --agent '*' \
  --yes

Chỉ cài cho Codex:

npx --yes skills@1.5.19 add itsddvn/skills-shared \
  --global \
  --skill idea-validator \
  --agent codex \
  --yes

Xem danh sách skill trước khi cài:

npx --yes skills@1.5.19 add itsddvn/skills-shared --list

Cài từ bản clone trên máy

git clone https://github.com/itsddvn/skills-shared.git
cd skills-shared
npx --yes skills@1.5.19 add . --list
npx --yes skills@1.5.19 add . --global --skill idea-validator --agent codex --yes

Sử dụng idea-validator

Yêu cầu một coding agent tương thích gọi skill, ví dụ:

Use $idea-validator full to validate this product idea: ...
Use $idea-validator compare to compare these ideas: ...
Use $idea-validator revalidate to review this report: ...

Các chế độ được hỗ trợ:

• quick: sàng lọc nhanh, kiểm tra điều kiện loại và đề xuất thử nghiệm xác thực tiếp theo.
• full: nghiên cứu có nguồn, sổ bằng chứng, chấm điểm và kết luận cuối.
• compare: so sánh công bằng với cùng giả định và một bảng điểm tổng hợp.
• revalidate: đánh giá lại báo cáo cũ bằng bằng chứng và chính sách hiện hành.

Đọc skills/idea-validator/SKILL.md để xem toàn bộ quy trình và quy tắc an toàn.

Cấu trúc repository

skills-shared/
├── skills/
│   └── idea-validator/
│       ├── SKILL.md
│       ├── agents/          # metadata dành riêng cho từng agent
│       ├── assets/          # dữ liệu tham chiếu được quản lý bằng Git
│       ├── evals/           # bài đánh giá hành vi và điều kiện kích hoạt
│       ├── references/      # hướng dẫn vận hành chi tiết
│       └── scripts/         # chấm điểm tất định và kiểm thử
├── scripts/                 # kiểm tra ở cấp catalog
├── .github/workflows/       # kiểm tra liên tục bằng CI
├── LICENSE
└── README.md

Repository chủ động không có SKILL.md ở thư mục gốc vì đây là một catalog, không phải gói chỉ chứa một skill.

Kiểm tra và chạy test

Chỉ cần Node.js 22.20+ và Python 3.9+. Skill không có dependency khi chạy; các dependency npm đã khóa phiên bản chỉ phục vụ kiểm tra catalog và Skills CLI.

npm ci --ignore-scripts        # cài đúng phiên bản công cụ từ package-lock.json
npm test                       # kiểm tra catalog và chạy toàn bộ test của skill
npm run validate               # kiểm tra cấu trúc skill và frontmatter
npm run test:idea-validator    # chạy test hồi quy của Idea Validator
npm run skills:list            # xem kết quả nhận diện của Skills CLI

idea-validator hiện có 29 test hồi quy chạy offline, bao phủ logic chấm điểm, hành vi CLI, hợp đồng báo cáo, kết quả so sánh và tính toàn vẹn của corpus.

Thêm một skill dùng chung

1. Tạo skills/<tên-kebab-case>/SKILL.md.
2. Khai báo hai trường name và description không rỗng trong YAML frontmatter.
3. Đặt hướng dẫn chi tiết trong references/, logic tất định trong scripts/ và tệp tái sử dụng trong assets/.
4. Thêm test và cập nhật bảng skill trong README này.
5. Chạy npm test và npm run skills:list trước khi mở pull request.

Không commit API key, dữ liệu khách hàng, thông tin xác thực, virtual environment được sinh ra hoặc thư mục cài agent trên máy cá nhân.

Giấy phép

MIT — xem LICENSE.