devskill 2.0.2

package/README.md

@@ -0,0 +1,123 @@
+<div align="center">
+  <h1>🚀 devskill: Supercharge Your AI Agents</h1>
+  <p><strong>Curated Coding Expertise for Cursor, GitHub Copilot, & AgentSkills</strong></p>
+  <p>
+    <a href="README.vn.md">🇻🇳 Read in Vietnamese (Đọc Tiếng Việt)</a> •
+    <a href="https://agentskills.io/home" target="_blank">About AgentSkills</a>
+  </p>
+</div>
+
+## 🤔 The Problem
+
+Are you tired of constantly reminding your AI assistant about your team's specific coding standards? Tired of generic Vue components when you need strict Ant Design + Tailwind integrations, or boilerplate REST endpoints when your team uses class-based APIs and Action Fallbacks?
+
+## 💡 The Solution
+
+**`devskill`** is a curated collection of highly specific, context-rich "Agent Skills" designed to align your AI with your exact development stack. Stop prompting, start building.
+
+By feeding your AI specialized `SKILL.md` documents, you **eliminate AI hallucinations** and strictly enforce your project's architecture.
+
+## ✨ Why You Need This
+
+- 🧠 **Instant Project Onboarding:** One command dumps all necessary context right into your `.agents/skills` folder.
+- 🎯 **Pinpoint Accuracy:** From niche Vue Options API patterns to Elixir Phoenix Ecto.Multi rules, get the code exactly how you want it.
+- ⚡ **Zero-Friction Setup:** Interactive, beautifully designed CLI makes managing skills effortless.
+
+---
+
+## 📦 Installation & Quick Start
+
+You can install these skills using the official [Agent Skills CLI](https://github.com/vercel-labs/skills).
+
+### Options 1: Install All Skills
+Perfect for getting the full collection into your project:
+
+```bash
+npx skills add vuluu2k/skills --skill='*'
+```
+
+### Options 2: Install Specific Skills
+If you only need a particular expertise:
+
+```bash
+# Install Vue Options API skill
+npx skills add vuluu2k/skills --skill='vue-options'
+
+# Install Pinia Options API skill
+npx skills add vuluu2k/skills --skill='pinia-options'
+```
+
+### Options 3: Interactive CLI
+We've also built an elegant, interactive CLI for advanced management (requires cloning this repo):
+
+```bash
+npx devskill install
+```
+
+---
+
+## 📚 Curated Collections
+
+Pick the exact brain-upgrade your AI needs.
+
+| Collection | Focus Area | Included Skills |
+|------------|------------|-----------------|
+| 🏗️ **`builderx_spa`** | Specialized BuilderX Frontend | `vue-options`, `pinia-options`, `builderx_spa-api`, `builderx_spa-permission`, `vue-antdv-tailwind` |
+| ⚙️ **`builderx_api`** | Phoenix Elixir Backend | `builderx_api-schemas`, `builderx_api-controllers`, `builderx_api-contexts` |
+| 🌟 **`vue3-standard`** | Pure Vue 3 Mastery | `vue`, `pinia`, `vue-best-practices`, `vue-router-best-practices`, `vue-testing-best-practices` |
+
+## 🛠️ Deep-Dive: Available Skills
+
+Some of the primary hand-crafted skills included in our collections:
+
+### Frontend & Vue Ecosystem
+- **`vue` / `vue-best-practices`**: Modern Vue 3 Composition API style with script setup, animation techniques, and advanced rendering.
+- **`pinia`**: State management using Composition API.
+- **`vue-options` / `pinia-options`**: The definitive best practices for organizations still leveraging the powerful Vue Options API style.
+- **`vue-router-best-practices`**: Avoid navigation infinite loops and lifecycle gotchas.
+- **`vue-testing-best-practices`**: Blackbox testing, Vitest setups, and E2E Playwright.
+
+### Advanced Architectural Patterns
+- **`builderx_spa-api`**: Deep API fetching rules + class-based endpoints pattern overriding standard HTTP.
+- **`builderx_spa-permission`**: Role-based access rules utilizing bitwise permissions.
+- **`vue-antdv-tailwind`**: The definitive guide to cleanly mixing Ant Design Vue components with Tailwind CSS utility classes.
+
+### Backend Mastery (Elixir / Phoenix)
+- **`builderx_api-schemas`**: Core Ecto schema conventions including custom json serializers.
+- **`builderx_api-controllers`**: Action fallback and standard tuple responses for Phoenix controllers.
+- **`builderx_api-contexts`**: Ecto.Multi and Outbox pattern usage for complex multi-step transactions.
+
+---
+
+## ⚙️ Generate & Manage Your Own Skills
+
+Want to build your own AI knowledge base? Fork or clone this repository to start creating your team's custom skill collection.
+
+1. **Clone the repo:**
+   ```bash
+   git clone https://github.com/vuluu2k/skills
+   cd skills
+   npm install
+   ```
+
+2. **Update `meta.ts`** with your own projects and sources.
+
+3. **Use the powerful CLI** to manage everything:
+   ```bash
+   npm start              # Open the interactive menu
+   npm start install      # Install skill collections to a target project
+   npm start init         # Clone tracked submodules from meta.ts
+   npm start sync         # Pull updates + sync vendor skills
+   npm start check        # Check for available remote updates
+   npm start cleanup      # Remove stale skills not listed in meta.ts
+   ```
+
+4. **Ask your AI agent to generate skills:**
+   > "Generate skills for `<project>` based on the docs in `sources/<project>/`"
+
+See [SKILL_GUIDE.md](SKILL_GUIDE.md) for detailed guidelines on writing the perfect AI skills.
+
+---
+<div align="center">
+  <p>Built with ❤️ by vuluu2k. License: MIT</p>
+</div>

package/README.vn.md

@@ -0,0 +1,104 @@
+<div align="center">
+  <h1>🚀 devskill: Nâng tầm AI Agent của bạn</h1>
+  <p><strong>Kho tri thức lập trình chuyên sâu cho Cursor, GitHub Copilot, & AgentSkills</strong></p>
+  <p>
+    <a href="README.md">🇺🇸 Read in English (Đọc Tiếng Anh)</a> •
+    <a href="https://agentskills.io/home" target="_blank">Về AgentSkills</a>
+  </p>
+</div>
+
+## 🤔 Vấn đề
+
+Bạn mệt mỏi vì phải liên tục nhắc nhở trợ lý AI về các tiêu chuẩn code riêng của team mình? Bạn chán ngấy việc nhận được các Vue component cơ bản khi bạn cần tích hợp chặt chẽ Ant Design + Tailwind, hoặc các REST endpoint mẫu khi team bạn sử dụng class-based API và Action Fallbacks?
+
+## 💡 Giải pháp
+
+**`devskill`** là một bộ sưu tập các "Agent Skills" được tuyển chọn kỹ lưỡng, giàu ngữ cảnh, được thiết kế để định hướng AI theo đúng stack phát triển của bạn. Ngừng viết prompt thủ công, bắt đầu xây dựng sản phẩm.
+
+Bằng cách cung cấp cho AI các tài liệu `SKILL.md` chuyên dụng, bạn sẽ **loại bỏ tình trạng AI "ảo tưởng" (hallucination)** và thực thi nghiêm ngặt kiến trúc dự án của mình.
+
+## ✨ Tại sao bạn cần công cụ này
+
+- 🧠 **Onboarding dự án tức thì:** Một lệnh duy nhất sẽ đưa toàn bộ ngữ cảnh cần thiết vào thư mục `.agents/skills` của bạn.
+- 🎯 **Độ chính xác tuyệt đối:** Từ các pattern niche của Vue Options API đến các quy tắc Elixir Phoenix Ecto.Multi, nhận code chính xác theo ý bạn.
+- ⚡ **Thiết lập không tốn sức:** CLI tương tác, thiết kế đẹp mắt giúp việc quản lý skills trở nên dễ dàng.
+
+---
+
+## 📦 Cài đặt & Bắt đầu nhanh
+
+Quên việc copy thủ công đi. Chúng tôi đã xây dựng một CLI tương tác thanh lịch để đưa kiến thức trực tiếpChạy CLI trong dự án của bạn:
+```bash
+npx devskill install
+```
+
+> **Mẹo:** Bạn cũng có thể cài đặt mọi skill trên toàn hệ thống bằng công cụ chính thức:  
+> `npx skills add vuluu2k/skills --skill='*'`
+
+---
+
+## 📚 Bộ sưu tập tuyển chọn (Collections)
+
+Chọn chính xác "nâng cấp não bộ" mà AI của bạn cần.
+
+| Bộ sưu tập | Lĩnh vực trọng tâm | Các Skills bao gồm |
+|------------|------------|-----------------|
+| 🏗️ **`builderx_spa`** | Frontend BuilderX chuyên dụng | `vue-options`, `pinia-options`, `builderx_spa-api`, `builderx_spa-permission`, `vue-antdv-tailwind` |
+| ⚙️ **`builderx_api`** | Backend Phoenix Elixir | `builderx_api-schemas`, `builderx_api-controllers`, `builderx_api-contexts` |
+| 🌟 **`vue3-standard`** | Làm chủ Vue 3 thuần túy | `vue`, `pinia`, `vue-best-practices`, `vue-router-best-practices`, `vue-testing-best-practices` |
+
+## 🛠️ Chi tiết: Các Skills hiện có
+
+Một số skill được viết tay tỉ mỉ nằm trong các bộ sưu tập:
+
+### Hệ sinh thái Frontend & Vue
+- **`vue` / `vue-best-practices`**: Phong cách Modern Vue 3 Composition API với script setup, kỹ thuật animation và rendering nâng cao.
+- **`pinia`**: Quản lý state sử dụng Composition API.
+- **`vue-options` / `pinia-options`**: Các best practices chuẩn mực cho các tổ chức vẫn đang tận dụng sức mạnh của Vue Options API.
+- **`vue-router-best-practices`**: Tránh lỗi vòng lặp điều hướng vô tận và các lỗi vòng đời.
+- **`vue-testing-best-practices`**: Blackbox testing, thiết lập Vitest và E2E Playwright.
+
+### Các Pattern Kiến trúc Nâng cao
+- **`builderx_spa-api`**: Các quy tắc fetch API chuyên sâu + pattern class-based endpoint thay thế HTTP tiêu chuẩn.
+- **`builderx_spa-permission`**: Quy tắc phân quyền dựa trên Role sử dụng bitwise permissions.
+- **`vue-antdv-tailwind`**: Hướng dẫn chuẩn để kết hợp mượt mà Ant Design Vue với Tailwind CSS.
+
+### Backend (Elixir / Phoenix)
+- **`builderx_api-schemas`**: Các quy ước Ecto schema bao gồm custom json serializers.
+- **`builderx_api-controllers`**: Action fallback và cấu trúc tuple phản hồi chuẩn cho Phoenix controller.
+- **`builderx_api-contexts`**: Sử dụng Ecto.Multi và Outbox pattern cho các transaction phức tạp nhiều bước.
+
+---
+
+## ⚙️ Tự tạo & Quản lý Skills của riêng bạn
+
+Bạn muốn xây dựng kho tri thức AI của riêng mình? Fork hoặc clone repo này để bắt đầu tạo bộ sưu tập skill tùy chỉnh cho team.
+
+1. **Clone repo:**
+   ```bash
+   git clone https://github.com/vuluu2k/skills
+   cd skills
+   npm install
+   ```
+
+2. **Cập nhật `meta.ts`** với các dự án và nguồn skill của bạn.
+
+3. **Sử dụng CLI mạnh mẽ** để quản lý:
+   ```bash
+   npm start              # Mở menu tương tác
+   npm start install      # Cài đặt bộ sưu tập skill vào dự án đích
+   npm start init         # Clone các submodule được theo dõi từ meta.ts
+   npm start sync         # Cập nhật + đồng bộ vendor skills
+   npm start check        # Kiểm tra cập nhật từ remote
+   npm start cleanup      # Xóa các skill cũ không có trong meta.ts
+   ```
+
+4. **Yêu cầu AI generate skills:**
+   > "Generate skills cho `<project>` dựa trên tài liệu trong `sources/<project>/`"
+
+Xem [SKILL_GUIDE.md](SKILL_GUIDE.md) để biết hướng dẫn chi tiết về cách viết một AI skill hoàn hảo.
+
+---
+<div align="center">
+  <p>Xây dựng với ❤️ bởi vuluu2k. License: MIT</p>
+</div>

package/SKILL_GUIDE.vn.md

@@ -0,0 +1,252 @@
+# SKILL_GUIDE.md 🌐 [[English](SKILL_GUIDE.md)]
+
+Hướng dẫn đầy đủ về cách tạo và quản lý AI agent skills trong repository này.
+
+---
+
+## Skill là gì?
+
+Một **skill** là một bộ các tệp Markdown dùng để dạy cho một AI agent cách làm việc với một công nghệ hoặc quy trình cụ thể. Agent sẽ đọc các tệp này trước khi viết mã để đảm bảo nó tuân theo các quy ước chính xác.
+
+---
+
+## Các loại Skill
+
+| Loại | Vị trí | Cách quản lý |
+|------|----------|---------------------|
+| **Manual** | `skills/{tên}/` | Viết thủ công |
+| **Generated** | `skills/{tên}/` | AI tạo ra từ `sources/{tên}/docs/` |
+| **Synced** | `skills/{tên}/` | Tự động copy từ `vendor/{tên}/skills/` |
+
+Cả ba loại đều tạo ra cấu trúc tệp giống nhau trong thư mục `skills/`.
+
+---
+
+## Cấu trúc thư mục
+
+```
+skills/{tên-skill}/
+├── SKILL.md                  ← Bắt buộc: tệp chỉ mục chính
+├── GENERATION.md             ← Cho generated skills: theo dõi source Git SHA
+├── SYNC.md                   ← Cho synced skills: theo dõi vendor Git SHA
+└── references/
+    ├── core-*.md             ← Các khái niệm cốt lõi (luôn luôn được đọc)
+    ├── features-*.md         ← Các tính năng tùy chọn
+    ├── advanced-*.md         ← Các chủ đề nâng cao
+    └── best-practices-*.md   ← Các pattern và các lỗi thường gặp
+```
+
+---
+
+## Định dạng SKILL.md
+
+```markdown
+---
+name: tên-skill
+description: Mô tả một dòng — đây là nội dung AI đọc để quyết định có tải skill hay không.
+metadata:
+  author: tên-của-bạn
+  version: "YYYY.MM.DD"
+  source: Viết thủ công / Tạo từ <url>
+---
+
+# Tiêu đề Skill
+
+> Tóm tắt và ngữ cảnh trong một dòng (ví dụ: phiên bản nào được hỗ trợ, các ràng buộc chính).
+
+## Cốt lõi (Core)
+
+| Chủ đề | Mô tả | Tham chiếu |
+|-------|-------------|-----------|
+| Tên chủ đề | Mô tả ngắn | [tên-ref](references/tên-ref.md) |
+
+## Tính năng (Features) (tùy chọn)
+
+| Chủ đề | Mô tả | Tham chiếu |
+|-------|-------------|-----------|
+| Tên tính năng | Mô tả ngắn | [tên-ref](references/tên-ref.md) |
+
+## Tra cứu nhanh (Quick Reference)
+
+Một ví dụ mã gọn gàng, độc lập hiển thị cách sử dụng phổ biến nhất.
+Phần này nên dễ hiểu mà không cần mở bất kỳ tệp tham chiếu nào.
+```javascript
+// Ví dụ mã ở đây
+```
+```
+
+---
+
+## Định dạng tệp tham chiếu (Reference File)
+
+```markdown
+---
+name: tên-tham-chiếu
+description: Mô tả ngắn gọn về những gì tham chiếu này đề cập.
+---
+
+# Tên chủ đề
+
+Giới thiệu ngắn gọn — khi nào và tại sao nên sử dụng cái này.
+
+## Phần A
+
+Giải thích + ví dụ mã.
+
+## Phần B
+
+Giải thích + ví dụ mã.
+
+<!--
+Nguồn tham khảo:
+- https://url-tai-lieu-chinh-thuc.com/topic
+-->
+```
+
+---
+
+## Cách đặt tên tệp tham chiếu
+
+Sử dụng prefix cho các tệp để chỉ định mức độ ưu tiên:
+
+| Prefix | Ý nghĩa |
+|--------|---------|
+| `core-` | Các kiến thức nền tảng bắt buộc |
+| `features-` | Các tính năng tùy chọn, tải khi cần |
+| `advanced-` | Các chủ đề phức tạp hoặc hiếm khi sử dụng |
+| `best-practices-` | Các pattern, quy ước, các lỗi thường gặp |
+
+Ví dụ: `core-state.md`, `features-transitions.md`, `best-practices-testing.md`
+
+---
+
+## Thêm một manual skill (Loại 1 — Viết thủ công)
+
+1. Tạo thư mục skill:
+   ```bash
+   mkdir -p skills/{tên-skill}/references
+   ```
+
+2. Tạo `skills/{tên-skill}/SKILL.md` — xem định dạng ở trên.
+
+3. Tạo các tệp tham chiếu trong `skills/{tên-skill}/references/`.
+
+4. Đăng ký tên skill trong `meta.ts` mục `manual`:
+   ```ts
+   export const manual = [
+     'vue-options',
+     'pinia-options',
+     '{tên-skill}', // ← thêm vào đây
+   ]
+   ```
+
+---
+
+## Thêm một generated skill (Loại 2 — Từ tài liệu OSS)
+
+1. Thêm repo vào `submodules` trong `meta.ts`:
+   ```ts
+   export const submodules = {
+     'tên-skill': 'https://github.com/org/repo',
+   }
+   ```
+
+2. Clone submodule:
+   ```bash
+   npm start init
+   ```
+
+3. Thêm một tệp hướng dẫn tạo (tùy chọn nhưng nên có):
+   ```
+   instructions/{tên-skill}.md
+   ```
+   Dùng tệp này để định nghĩa các quy ước (ví dụ: ưu tiên TypeScript, tránh các pattern nhất định).
+
+4. Đọc tài liệu từ `sources/{tên-skill}/` và viết các tệp skill một cách thủ công vào `skills/{tên-skill}/`.
+
+5. Tạo tệp `skills/{tên-skill}/GENERATION.md`:
+   ```markdown
+   # Thông tin tạo (Generation Info)
+
+   - **Nguồn:** `sources/{tên-skill}`
+   - **Git SHA:** `<run: cd sources/{tên-skill} && git rev-parse HEAD>`
+   - **Ngày tạo:** YYYY-MM-DD
+   ```
+
+### Cập nhật một Generated Skill
+
+1. Kiểm tra những gì đã thay đổi kể từ lần tạo cuối:
+   ```bash
+   cd sources/{tên-skill}
+   git diff {old-sha}..HEAD -- docs/
+   ```
+
+2. Cập nhật các tệp tham chiếu bị ảnh hưởng.
+
+3. Cập nhật `GENERATION.md` với Git SHA mới.
+
+---
+
+## Thêm một synced skill (Loại 3 — Vendor)
+
+1. Thêm vendor vào `meta.ts`:
+   ```ts
+   export const vendors = {
+     'tên-vendor': {
+       source: 'https://github.com/org/repo',
+       skills: {
+         'tên-skill-nguồn': 'tên-skill-đầu-ra',
+       }
+     }
+   }
+   ```
+
+2. Clone vendor submodule:
+   ```bash
+   npm start init
+   ```
+
+3. Đồng bộ skill:
+   ```bash
+   npm start sync
+   ```
+   Việc này sẽ copy tệp từ `vendor/{tên}/skills/{skill}/` vào `skills/{tên-đầu-ra}/` và tạo `SYNC.md`.
+
+> ⚠️ **Không** chỉnh sửa trực tiếp các tệp synced skill. Các thay đổi phải được thực hiện ở upstream vendor repo.
+
+---
+
+## Thêm một tệp hướng dẫn (Instruction File)
+
+Tạo `instructions/{tên-skill}.md` để định nghĩa các quy ước cho AI-generated hoặc AI-updated skills.
+
+```markdown
+- Ưu tiên TypeScript hơn JavaScript.
+- Luôn luôn dùng pattern X, không bao giờ dùng pattern Y.
+- Đối tượng mục tiêu là người dùng Options API, không đề cập đến Composition API.
+```
+
+Tệp này sẽ được đọc cùng với tài liệu nguồn khi yêu cầu AI tạo hoặc cập nhật skill.
+
+---
+
+## Các lệnh CLI
+
+```bash
+npm start              # Menu tương tác
+npm start init         # Clone các submodules được đăng ký trong meta.ts
+npm start sync         # Kéo các bản cập nhật + đồng bộ tất cả vendor skills
+npm start check        # Kiểm tra xem submodules có bản cập nhật mới không
+npm start cleanup      # Xóa các skills/submodules không có trong meta.ts
+```
+
+---
+
+## Hướng dẫn viết
+
+1. **Viết cho agent, không phải cho người** — tránh viết văn dài dòng, ưu tiên các gạch đầu dòng ngắn gọn và các ví dụ mã.
+2. **Một khái niệm cho mỗi tệp** — chia nhỏ các chủ đề lớn thành nhiều tệp tham chiếu.
+3. **Luôn luôn bao gồm mã** — mỗi phần nên có một ví dụ hoạt động được.
+4. **Giải thích các sự đánh đổi** — không chỉ nói *làm thế nào*, mà còn *khi nào* và *tại sao*.
+5. **Đảm bảo tính nhất quán** — sử dụng TypeScript trừ khi skill nhắm mục tiêu cụ thể đến JavaScript.
+6. **Tránh trùng lặp** — nếu hai tham chiếu trùng nhau nhiều, hãy hợp nhất hoặc liên kết chéo chúng.

package/bin/devskill.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '../scripts/cli.ts');
+
+const args = ['tsx', cliPath, ...process.argv.slice(2)];
+const result = spawnSync('npx', args, { stdio: 'inherit' });
+process.exit(result.status ?? 1);

package/meta.ts

@@ -0,0 +1,123 @@
+export interface VendorSkillMeta {
+  official?: boolean
+  source: string
+  skills: Record<string, string> // sourceSkillName -> outputSkillName
+}
+
+/**
+ * Repositories to clone as submodules and generate skills from their docs.
+ * After cloning, read docs and generate skills manually into skills/{name}/
+ * Then update the Git SHA in skills/{name}/GENERATION.md
+ *
+ * Format: { 'skill-name': 'https://github.com/org/repo' }
+ */
+export const submodules: Record<string, string> = {
+  // Example: add repos you want to generate skills from
+  // 'react': 'https://github.com/reactjs/react.dev',
+  'vue': 'https://github.com/vuejs/docs',
+  'pinia': 'https://github.com/vuejs/pinia',
+}
+
+/**
+ * Repositories that already maintain their own skills directory.
+ * The CLI will clone them and sync the specified skills automatically.
+ *
+ * Format: { 'vendor-name': { source: 'repo-url', skills: { 'source-skill': 'output-skill' } } }
+ */
+export const vendors: Record<string, VendorSkillMeta> = {
+  // Example: sync skills from a repo that already has them
+  // 'vueuse': {
+  //   source: 'https://github.com/vueuse/vueuse',
+  //   skills: { 'vueuse-functions': 'vueuse-functions' }
+  // },
+  'vuejs-ai': {
+    source: 'https://github.com/vuejs-ai/skills',
+    skills: {
+      'vue-best-practices': 'vue-best-practices',
+      'vue-router-best-practices': 'vue-router-best-practices',
+      'vue-testing-best-practices': 'vue-testing-best-practices',
+      'vue-options-api-best-practices': 'vue-options-api-best-practices',
+      'vue-pinia-best-practices': 'vue-pinia-best-practices',
+      'vue-jsx-best-practices': 'vue-jsx-best-practices',
+    },
+  },
+  'web-design-guidelines': {
+    source: 'https://github.com/vercel-labs/agent-skills',
+    skills: {
+      'composition-patterns': 'composition-patterns',
+      'web-design-guidelines': 'web-design-guidelines',
+      'react-best-practices': 'react-best-practices',
+      'deploy-to-vercel': 'deploy-to-vercel',
+      'react-native-skills': 'react-native-skills',
+      'vercel-cli-with-tokens': 'vercel-cli-with-tokens',
+    },
+  },
+  'slidev': {
+    official: true,
+    source: 'https://github.com/slidevjs/slidev',
+    skills: {
+      slidev: 'slidev',
+    },
+  },
+  'vueuse': {
+    official: true,
+    source: 'https://github.com/vueuse/vueuse',
+    skills: {
+      'vueuse-functions': 'vueuse-functions',
+    },
+  },
+  'tsdown': {
+    official: true,
+    source: 'https://github.com/rolldown/tsdown',
+    skills: {
+      tsdown: 'tsdown',
+    },
+  },
+  'turborepo': {
+    official: true,
+    source: 'https://github.com/vercel/turborepo',
+    skills: {
+      turborepo: 'turborepo',
+    },
+  },
+}
+
+export const manual = [
+  'vue-options',
+  'pinia-options',
+  'pinia',
+  'vue',
+  'builderx_spa-api',
+  'builderx_spa-permission',
+  'builderx_spa-design',
+  'vue-antdv-tailwind',
+  'builderx_api-schemas',
+  'builderx_api-controllers',
+  'builderx_api-contexts',
+]
+
+/**
+ * Collections of skills grouped by target projects/repos.
+ * Use `npm start install` to quickly copy a batch of skills to a local project.
+ */
+export const collections: Record<string, string[]> = {
+  'vue3-standard': [
+    'vue',
+    'pinia',
+    'vue-best-practices',
+    'vue-router-best-practices',
+    'vue-testing-best-practices'
+  ],
+  'builderx_spa': [
+    'vue-options',
+    'pinia-options',
+    'builderx_spa-api',
+    'builderx_spa-permission',
+    'builderx_spa-design'
+  ],
+  'builderx_api': [
+    'builderx_api-schemas',
+    'builderx_api-controllers',
+    'builderx_api-contexts'
+  ]
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "devskill",
+  "version": "2.0.2",
+  "type": "module",
+  "bin": {
+    "devskill": "bin/devskill.js"
+  },
+  "scripts": {
+    "start": "tsx scripts/cli.ts",
+    "prepare": "git submodule update --init --recursive",
+    "release": "npm publish --access public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "tsx": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/publish.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# Exit immediately if a command exits with a non-zero status
+set -e
+
+echo "📦 Chuẩn bị Publish package devskill lên NPM..."
+
+# 1. Kiểm tra trạng thái đăng nhập NPM
+if ! npm whoami > /dev/null 2>&1; then
+  echo "⚠️ Bạn chưa đăng nhập NPM. Hệ thống sẽ tự động bật giao diện đăng nhập (Trình duyệt) ngay sau đây..."
+  npm login
+  # Check lại xem đăng nhập thành công chưa
+  if ! npm whoami > /dev/null 2>&1; then
+    echo "❌ LỖI: Đăng nhập thất bại hoặc bị huỷ lệnh. Vui lòng thử lại sau."
+    exit 1
+  fi
+fi
+
+NPM_USER=$(npm whoami)
+echo "✅ Đã đăng nhập NPM với tài khoản: $NPM_USER"
+
+if [[ "$NPM_USER" != "vuluu2k" ]]; then
+  echo "⚠️ CẢNH BÁO: Package trong package.json đang được đặt tên là devskill."
+  echo "Hãy chắc chắn rằng tài khoản '$NPM_USER' của bạn có quyền publish package 'devskill' trên npmjs.com."
+  echo ""
+fi
+
+# 2. Tuỳ chọn tăng Version (Semantic Versioning)
+echo "Bạn có muốn tự động tăng phiên bản (Version Bump) không?"
+echo "Nhập patch (chữa lỗi), minor (tính năng nhỏ), major (thay đổi lớn), hoặc nhấn Enter để bỏ qua:"
+read -p "> " BUMP_TYPE
+
+if [ -n "$BUMP_TYPE" ]; then
+  npm version "$BUMP_TYPE"
+  echo "✅ Đã tăng phiên bản thành công!"
+fi
+
+# 3. Đẩy code lên GitHub (nếu rảnh tay)
+read -p "Đẩy toàn bộ thay đổi và Tag version mới lên GitHub luôn không? (y/N): " PUSH_GIT
+if [[ "$PUSH_GIT" =~ ^[Yy]$ ]]; then
+  git push
+  git push --tags
+  echo "✅ Đã đẩy code an toàn lên GitHub."
+fi
+
+# 4. Tiến hành Publish
+echo "🚀 Đang tiến hành Publish lên NPM Registry..."
+npm publish --access public
+
+echo "🎉 CHÚC MỪNG! Đã publish thành công!"