Chào mọi người!
Tôi đã làm việc trên một thứ mà tôi muốn chia sẻ với bạn. Như bạn biết, tôi đã bắt đầu dựa vào AI assistants để làm phần lớn công việc coding, nhưng tôi vẫn review mọi thứ được tạo ra.
Tôi ngày càng cảm thấy khó chịu với lượng “code rác” (slop) được tạo ra và số lượng chỉnh sửa tôi phải làm. Sau nhiều năm làm việc với Node.js, Fastify và TypeScript, tôi đã tích lũy được rất nhiều kinh nghiệm: những pattern hiệu quả, những công cụ tiết kiệm thời gian và những “cái bẫy” dễ gặp phải. Tôi cần AI assistant của mình đạt được (hoặc ít nhất là tiệm cận) kỳ vọng đó.
Tôi quyết định tổ chức tất cả những điều này thành một bộ sưu tập mà AI assistant có thể sử dụng để giúp tôi làm việc nhanh hơn. Đây là repo skills của tôi, bạn có thể bắt đầu sử dụng chỉ với lệnh: npx skills add mcollina/skills. Repo này mã hóa các sở thích và best practices của tôi để tôi không phải lặp lại chúng mỗi lần làm việc. Có thể bạn cũng sẽ thấy nó hữu ích.
Trong repo có gì?
Repo bao gồm các skills cho:
fastify
Các best practices cho phát triển Fastify — lifecycle của hooks, kiến trúc plugin và tối ưu hiệu năng. Dựa trên nhiều năm làm việc với Fastify core.
node
Các best practices cho Node.js — pattern của event loop, xử lý lỗi async, stream processing và Node.js test runner. Bao gồm các pitfalls phổ biến và pattern hiện đại từ Node.js core.
nodejs-core
Các kiến thức nội bộ sâu hơn như C++ addons, internals của V8, pattern của libuv và hệ thống build. Dành cho việc hiểu Node.js ở mức thấp nhất.
typescript-magician
Type system nâng cao, generic phức tạp và loại bỏ kiểu any. Lấy cảm hứng từ Matt Pocock tại TotalTypeScript — khóa học của anh ấy rất chất lượng.
octocat
Workflow Git và GitHub sử dụng gh CLI. Bao gồm PR, issue, release và quản lý repository.
oauth
OAuth 2.0/2.1 tích hợp với Fastify. Dựa trên RFC 6749 và công việc trên @fastify/oauth2.
linting-neostandard-eslint9
Linting với neostandard và ESLint v9 flat config. Cách lint hiện đại, gọn gàng.
documentation
Viết tài liệu kỹ thuật theo framework Diátaxis — gồm tutorials, how-to guides, reference và explanation.
Mỗi skill bao gồm markdown files, code snippets và config examples. AI assistant của tôi đọc chúng và áp dụng các pattern khi hỗ trợ code review hoặc viết feature mới. Nó giống như pair programming với một developer giàu kinh nghiệm — chỉ khác là nó nhớ cả những chi tiết như V8 flag bạn từng nhắc tới từ năm 2022.
Skill là gì?
Skills tuân theo chuẩn Agent Skills mở — được khởi xướng bởi Anthropic và hiện được nhiều AI agent hỗ trợ.
Một skill là một thư mục bao gồm:
- SKILL.md — metadata và instructions
- scripts/ — code thực thi (tùy chọn)
- references/ — tài liệu (tùy chọn)
- assets/ — template (tùy chọn)
File SKILL.md cần có name và description trong phần frontmatter, sau đó là nội dung markdown chứa instructions. Agent sẽ load metadata trước, và chỉ load full instructions khi cần.
Chuẩn này hoạt động với OpenAI Codex, GitHub Copilot, Claude Code, skills.sh và nhiều nền tảng khác. Thậm chí còn có agent chuyên cho game — bạn có thể xem pi coding-agent nếu muốn thử thứ gì đó khác biệt.
Tiếp theo là gì?
Tôi sẽ tiếp tục bổ sung thêm skills khi làm việc trên các project mới, đặc biệt là về tối ưu hiệu năng, bảo mật và deployment patterns. Nếu bạn thấy hữu ích, hãy cho tôi biết!
Xem repo tại github.com/mcollina/skills.
Cảm ơn!