devskill 2.0.5 → 2.0.7

package/landing/app/[locale]/page.tsx

@@ -76,10 +76,10 @@ export default function LandingPage() {
             <h1 className="text-6xl md:text-8xl font-extrabold mb-8 tracking-tight bg-clip-text text-transparent bg-gradient-to-br from-white via-zinc-200 to-zinc-500 pb-2">
               {t('title')}
             </h1>
-            <p className="text-xl md:text-2xl text-zinc-300 max-w-3xl mx-auto mb-12 leading-relaxed text-balance font-light">
+            <p className="text-xl md:text-2xl text-zinc-300 max-w-5xl mx-auto mb-12 leading-relaxed text-balance font-light">
               {t('subtitle')}
             </p>
-            <p className="text-lg text-zinc-400 max-w-2xl mx-auto mb-12 leading-relaxed text-balance">
+            <p className="text-lg text-zinc-400 max-w-4xl mx-auto mb-12 leading-relaxed text-balance">
               {h('description')}
             </p>
             <div className="flex flex-col sm:flex-row items-center justify-center gap-4 w-full max-w-md mx-auto sm:max-w-none">
@@ -270,6 +270,72 @@ export default function LandingPage() {
             </Card>
           </div>
         </section>
+
+        {/* Architecture Section */}
+        <section id="architecture" className="container mx-auto px-4 mb-40 relative z-10">
+          <div className="text-center mb-16">
+            <h2 className="text-4xl md:text-5xl font-extrabold mb-6 tracking-tight text-white">{t('architecture_title')}</h2>
+            <div className="w-24 h-1.5 bg-gradient-to-r from-cyan-400 to-rose-500 mx-auto rounded-full mb-6" />
+            <p className="text-xl text-zinc-400 max-w-3xl mx-auto leading-relaxed">{t('architecture_desc')}</p>
+          </div>
+          
+          <div className="grid md:grid-cols-2 gap-8 max-w-5xl mx-auto">
+            <Card className="bg-zinc-900/60 border-cyan-400/20 backdrop-blur-xl hover:bg-zinc-900/80 hover:border-cyan-400/50 hover:-translate-y-2 hover:shadow-2xl hover:shadow-cyan-400/20 transition-all duration-300 group overflow-hidden relative">
+              <div className="absolute top-0 right-0 p-32 bg-cyan-400/5 rounded-full blur-[80px] -mr-16 -mt-16 transition-opacity opacity-0 group-hover:opacity-100" />
+              <CardHeader className="relative z-10">
+                <div className="w-14 h-14 rounded-2xl bg-cyan-400/10 flex items-center justify-center mb-6 group-hover:scale-110 transition-transform duration-500 border border-cyan-400/20">
+                  <Database className="w-7 h-7 text-cyan-400" />
+                </div>
+                <CardTitle className="text-2xl text-white font-bold tracking-tight">{t('sources_title')}</CardTitle>
+              </CardHeader>
+              <CardContent className="relative z-10">
+                <p className="text-zinc-300 leading-relaxed text-base">{t('sources_desc')}</p>
+              </CardContent>
+            </Card>
+
+            <Card className="bg-zinc-900/60 border-rose-500/20 backdrop-blur-xl hover:bg-zinc-900/80 hover:border-rose-500/50 hover:-translate-y-2 hover:shadow-2xl hover:shadow-rose-500/20 transition-all duration-300 group overflow-hidden relative">
+              <div className="absolute top-0 right-0 p-32 bg-rose-500/5 rounded-full blur-[80px] -mr-16 -mt-16 transition-opacity opacity-0 group-hover:opacity-100" />
+              <CardHeader className="relative z-10">
+                <div className="w-14 h-14 rounded-2xl bg-rose-500/10 flex items-center justify-center mb-6 group-hover:scale-110 transition-transform duration-500 border border-rose-500/20">
+                  <Boxes className="w-7 h-7 text-rose-500" />
+                </div>
+                <CardTitle className="text-2xl text-white font-bold tracking-tight">{t('vendor_title')}</CardTitle>
+              </CardHeader>
+              <CardContent className="relative z-10">
+                <p className="text-zinc-300 leading-relaxed text-base">{t('vendor_desc')}</p>
+              </CardContent>
+            </Card>
+          </div>
+        </section>
+
+        {/* Contribute Section */}
+        <section id="contribute" className="container mx-auto px-4 mb-40 text-center relative z-10">
+          <div className="max-w-4xl mx-auto bg-gradient-to-br from-zinc-900/80 to-zinc-950 border border-white/10 p-10 md:p-14 rounded-3xl shadow-2xl relative overflow-hidden group">
+            <div className="absolute top-0 right-0 p-32 bg-rose-500/10 rounded-full blur-[100px] -mr-16 -mt-16 pointer-events-none" />
+            <div className="absolute bottom-0 left-0 p-32 bg-cyan-400/10 rounded-full blur-[100px] -ml-16 -mb-16 pointer-events-none" />
+            
+            <h2 className="text-3xl md:text-5xl font-extrabold mb-6 tracking-tight text-white">{t('contribute_title')}</h2>
+            <p className="text-lg md:text-xl text-zinc-300 max-w-3xl mx-auto mb-10 leading-relaxed font-light">
+              {t('contribute_desc')}
+            </p>
+            <div className="flex flex-col sm:flex-row items-center justify-center gap-4">
+              <a 
+                href="https://github.com/vuluu2k/skills/issues"
+                target="_blank"
+                className="px-8 py-4 rounded-xl font-bold bg-white text-zinc-950 hover:bg-zinc-200 transition-colors shadow-lg shadow-white/10"
+              >
+                {t('contribute_cta_issue')}
+              </a>
+              <a 
+                href="https://github.com/vuluu2k/skills"
+                target="_blank"
+                className="px-8 py-4 rounded-xl font-bold bg-zinc-800 text-white hover:bg-zinc-700 border border-white/10 transition-colors"
+              >
+                {t('contribute_cta_build')}
+              </a>
+            </div>
+          </div>
+        </section>
       </main>
 
       <footer className="border-t border-white/10 py-12 bg-zinc-950/80 backdrop-blur-sm">

package/landing/messages/en.json

@@ -5,9 +5,19 @@
     "problem": "The Problem",
     "solution": "The Solution",
     "why_devskill": "The power of devskill",
-    "installation": "Simple Installation",
+    "installation": "Installation & Quick Start",
     "collections": "Skill Collections",
-    "footer": "Built with ❤️ by vuluu2k. License: MIT"
+    "footer": "© 2026 devskill. Empower your AI assistants.",
+    "contribute_title": "Build & Contribute",
+    "contribute_desc": "Does your team have unique coding standards? You can easily build a completely customized AI brain! If you have any awesome frameworks or best-practices you'd like to share, create an Issue on GitHub so we can add it to devskill.",
+    "contribute_cta_issue": "💡 Suggest a Skill",
+    "contribute_cta_build": "🛠️ Build Your Own",
+    "architecture_title": "Smart Directory Architecture",
+    "architecture_desc": "More than just a CLI, devskill provides a clearly stratified Knowledge Base management pipeline.",
+    "sources_title": "The Root (sources/)",
+    "sources_desc": "The raw data layer. Stores official documentation, template repos, and guidelines (often tracked as git submodules). AI reads this to generate your SKILL.md rules.",
+    "vendor_title": "Submodules (vendor/)",
+    "vendor_desc": "Your external dependency layer. Automatically syncs community or third-party high-quality skills into your project. Keep them fresh with a single 'npm start sync'."
   },
   "Hero": {
     "badge": "🚀 NEW: devskill v2.0",

package/landing/messages/vi.json

@@ -5,9 +5,19 @@
     "problem": "Vấn đề",
     "solution": "Giải pháp",
     "why_devskill": "Sức mạnh thực sự của devskill",
-    "installation": "Cài đặt đơn giản",
-    "collections": "Thư viện kỹ năng (Collections)",
-    "footer": "Thiết kế với ❤️ bởi vuluu2k. Giấy phép: MIT"
+    "installation": "Cài đặt & Trải nghiệm",
+    "collections": "Bộ sưu tập Skills",
+    "footer": "© 2026 devskill. Xây dựng bộ não mạnh mẽ nhất cho AI của bạn.",
+    "contribute_title": "Tự Xây Dựng & Đóng Góp",
+    "contribute_desc": "Đội ngũ của bạn có quy chuẩn code riêng? Đừng lo, bạn có thể tự build bộ não AI chuyên biệt cho team! Nếu bạn biết một framework hay best-practices nào đỉnh cao, hãy tạo Issue trên GitHub để mình thêm vào devskill nhé.",
+    "contribute_cta_issue": "💡 Gợi ý Skills (Tạo Issue)",
+    "contribute_cta_build": "🛠️ Tự Build Skills",
+    "architecture_title": "Cấu trúc Thư mục Thông minh",
+    "architecture_desc": "Không chỉ là một CLI, devskill cung cấp vòng đời quản lý tri thức (Knowledge Base) phân tầng rõ rệt.",
+    "sources_title": "Nguồn gốc (sources/)",
+    "sources_desc": "Nơi chứa tài liệu gốc, mã nguồn mẫu, official documentation (thường track dưới dạng git submodules). AI sẽ đọc và đọc hiểu tự động để trích xuất các quy chuẩn ra file SKILL.md.",
+    "vendor_title": "Cộng đồng (vendor/)",
+    "vendor_desc": "Kho lưu trữ các skill chất lượng cao được chia sẻ từ cộng đồng hoặc tổ chức khác. Chỉ cần 1 lệnh 'npm start sync' để cập nhật liên tục mọi thay đổi về máy!"
   },
   "Hero": {
     "badge": "🚀 MỚI: devskill v2.0",

package/meta.ts

@@ -1,7 +1,7 @@
 export interface VendorSkillMeta {
   official?: boolean
   source: string
-  skills: Record<string, string> // sourceSkillName -> outputSkillName
+  skills?: Record<string, string> // sourceSkillName -> outputSkillName. If omitted, auto-discovers all subdirectories.
 }
 
 /**
@@ -80,6 +80,23 @@ export const vendors: Record<string, VendorSkillMeta> = {
       turborepo: 'turborepo',
     },
   },
+  'next-skills': {
+    official: true,
+    source: 'https://github.com/vercel-labs/next-skills',
+    skills: {
+      'next-best-practices': 'next-best-practices',
+      'next-cache-components': 'next-cache-components',
+      'next-upgrade': 'next-upgrade',
+    },
+  },
+  'anthropics': {
+    official: true,
+    source: 'https://github.com/anthropics/skills',
+  },
+  'shacdn-ui': {
+    official: true,
+    source: 'https://github.com/shadcn-ui/ui',
+  }
 }
 
 export const manual = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devskill",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "Equip Cursor, Windsurf, Cline, Antigravity, Claude Code, Codex, GitHub Copilot and other AI Agents with expert programming superpowers via a single interactive prompt.",
   "homepage": "https://vskill.vercel.app",
   "repository": {
@@ -18,10 +18,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "@inquirer/prompts": "^8.3.2",
+    "enquirer": "^2.4.1",
+    "prompts": "^2.4.2",
     "tsx": "^4.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
     "typescript": "^5.5.0"
   }
 }

package/scripts/cli.ts

@@ -4,6 +4,7 @@ import { dirname, join } from 'node:path'
 import process from 'node:process'
 import { fileURLToPath } from 'node:url'
 import * as p from '@clack/prompts'
+import prompts from 'prompts'
 import { collections, manual, submodules, vendors } from '../meta.ts'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -63,7 +64,7 @@ interface Project {
 
 interface VendorConfig {
   source: string
-  skills: Record<string, string>
+  skills?: Record<string, string>
 }
 
 async function initSubmodules(skipPrompt = false) {
@@ -187,17 +188,39 @@ async function syncSubmodules() {
       continue
     }
 
-    if (!existsSync(vendorSkillsPath)) {
-      p.log.warn(`No skills directory in vendor/${vendorName}/skills/`)
+    let skillsToSync: Record<string, string> = {}
+    
+    if (vendorConfig.skills && Object.keys(vendorConfig.skills).length > 0) {
+      if (!existsSync(vendorSkillsPath)) {
+        p.log.warn(`No skills directory in vendor/${vendorName}/skills/`)
+        continue
+      }
+      skillsToSync = vendorConfig.skills
+    } else {
+      const searchPath = existsSync(vendorSkillsPath) ? vendorSkillsPath : vendorPath
+      if (existsSync(searchPath)) {
+         const entries = readdirSync(searchPath, { withFileTypes: true })
+         for (const entry of entries) {
+           if (entry.isDirectory() && !entry.name.startsWith('.')) {
+             skillsToSync[entry.name] = entry.name
+           }
+         }
+      }
+    }
+
+    if (Object.keys(skillsToSync).length === 0) {
+      p.log.warn(`No skills found or mapped for vendor: ${vendorName}`)
       continue
     }
 
-    for (const [sourceSkillName, outputSkillName] of Object.entries(vendorConfig.skills)) {
-      const sourceSkillPath = join(vendorSkillsPath, sourceSkillName)
+    for (const [sourceSkillName, outputSkillName] of Object.entries(skillsToSync)) {
+      const sourceSkillPath = existsSync(vendorSkillsPath) 
+        ? join(vendorSkillsPath, sourceSkillName) 
+        : join(vendorPath, sourceSkillName)
       const outputPath = join(root, 'skills', outputSkillName)
 
       if (!existsSync(sourceSkillPath)) {
-        p.log.warn(`Skill not found: vendor/${vendorName}/skills/${sourceSkillName}`)
+        p.log.warn(`Skill not found: ${sourceSkillPath}`)
         continue
       }
 
@@ -276,7 +299,7 @@ async function checkUpdates() {
     const behind = execSafe('git rev-list HEAD..@{u} --count', path)
     const count = behind ? Number.parseInt(behind) : 0
     if (count > 0) {
-      const skillNames = Object.values(vendorConfig.skills).join(', ')
+      const skillNames = vendorConfig.skills ? Object.values(vendorConfig.skills).join(', ') : 'all'
       updates.push({ name: `${name} (${skillNames})`, type: 'vendor', behind: count })
     }
   }
@@ -298,8 +321,10 @@ function getExpectedSkillNames(): Set<string> {
     expected.add(name)
   for (const config of Object.values(vendors)) {
     const vendorConfig = config as VendorConfig
-    for (const outputName of Object.values(vendorConfig.skills))
-      expected.add(outputName)
+    if (vendorConfig.skills) {
+      for (const outputName of Object.values(vendorConfig.skills))
+        expected.add(outputName)
+    }
   }
   for (const name of manual)
     expected.add(name)
@@ -364,7 +389,7 @@ async function cleanup(skipPrompt = false) {
   }
 }
 
-async function installSkills() {
+async function installSkills(targetCollectionNames: string[] = []) {
   const spinner = p.spinner()
 
   const allCollections: Record<string, string[]> = { ...collections }
@@ -378,23 +403,33 @@ async function installSkills() {
     return
   }
 
-  const selectedCollectionNames = await p.multiselect({
-    message: 'Select collections to install (Space to select, Enter to confirm)',
-    options: Object.keys(allCollections).map(name => ({
-      value: name,
-      label: name,
-      hint: `${allCollections[name].length} skills`
-    }))
-  })
+  let selectedCollectionNames: string[] = []
 
-  if (p.isCancel(selectedCollectionNames)) {
-    p.cancel('Cancelled')
-    return
-  }
+  if (targetCollectionNames.length > 0) {
+    const invalid = targetCollectionNames.filter(name => !allCollections[name])
+    if (invalid.length > 0) {
+      p.log.error(`Collections not found: ${invalid.join(', ')}`)
+      return
+    }
+    selectedCollectionNames = targetCollectionNames
+  } else {
+    const response = await prompts({
+      type: 'autocompleteMultiselect',
+      name: 'selected',
+      message: 'Search and select collections to install (Space to select, Enter to confirm)',
+      choices: Object.keys(allCollections).map(name => ({
+        title: name,
+        value: name,
+        description: `${allCollections[name].length} skills`
+      }))
+    })
 
-  if (selectedCollectionNames.length === 0) {
-    p.log.warn('No collections selected')
-    return
+    if (!response.selected || response.selected.length === 0) {
+      p.log.warn('No collections selected (or canceled)')
+      return
+    }
+
+    selectedCollectionNames = response.selected
   }
 
   const targetProject = await p.text({
@@ -492,7 +527,7 @@ async function installSkills() {
   spinner.stop(`Installed ${successCount}/${selectedSkills.length} skills to target project`)
 }
 
-async function installSpecificSkills() {
+async function installSpecificSkills(targetSkillNames: string[] = []) {
   const spinner = p.spinner()
 
   const allSkills = getExistingSkillNames()
@@ -502,22 +537,32 @@ async function installSpecificSkills() {
     return
   }
 
-  const selectedSkills = await p.multiselect({
-    message: 'Select specific skills to install (Space to select, Enter to confirm)',
-    options: allSkills.map(name => ({
-      value: name,
-      label: name
-    }))
-  })
+  let selectedSkills: string[] = []
 
-  if (p.isCancel(selectedSkills)) {
-    p.cancel('Cancelled')
-    return
-  }
+  if (targetSkillNames.length > 0) {
+    const invalid = targetSkillNames.filter(name => !allSkills.includes(name))
+    if (invalid.length > 0) {
+      p.log.error(`Skills not found: ${invalid.join(', ')}`)
+      return
+    }
+    selectedSkills = targetSkillNames
+  } else {
+    const response = await prompts({
+      type: 'autocompleteMultiselect',
+      name: 'selected',
+      message: 'Search and select individual skills to install (Space to select, Enter to confirm)',
+      choices: allSkills.map(name => ({
+        title: name,
+        value: name
+      }))
+    })
 
-  if (selectedSkills.length === 0) {
-    p.log.warn('No skills selected')
-    return
+    if (!response.selected || response.selected.length === 0) {
+      p.log.warn('No skills selected (or canceled)')
+      return
+    }
+
+    selectedSkills = response.selected
   }
 
   const targetProject = await p.text({
@@ -612,10 +657,88 @@ async function installSpecificSkills() {
   spinner.stop(`Installed ${successCount}/${selectedSkills.length} skills to target project`)
 }
 
+async function findSkills(query?: string) {
+  const allSkills = getExistingSkillNames()
+  p.intro(`Search results for ${query ? `"${query}"` : 'all'}`)
+  
+  const allCollections: Record<string, string[]> = { ...collections }
+  for (const [vendorName, config] of Object.entries(vendors)) {
+    const vendorConfig = config as VendorConfig
+    let vendorSkills: string[] = []
+    
+    if (vendorConfig.skills && Object.keys(vendorConfig.skills).length > 0) {
+      vendorSkills = Object.values(vendorConfig.skills)
+    } else {
+      const vendorPath = join(root, 'vendor', vendorName)
+      const vendorSkillsPath = join(vendorPath, 'skills')
+      const searchPath = existsSync(vendorSkillsPath) ? vendorSkillsPath : (existsSync(vendorPath) ? vendorPath : null)
+      
+      if (searchPath) {
+        const entries = readdirSync(searchPath, { withFileTypes: true })
+        for (const entry of entries) {
+          if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            vendorSkills.push(entry.name)
+          }
+        }
+      }
+    }
+    
+    if (vendorSkills.length > 0) {
+      allCollections[vendorName] = vendorSkills
+    }
+  }
+
+  let q = ''
+  if (!query) {
+    const userInput = await p.text({
+      message: 'Enter keyword to search (leave empty to list all):',
+      placeholder: 'e.g. vue'
+    })
+    
+    if (p.isCancel(userInput)) {
+      p.cancel('Cancelled')
+      return
+    }
+    q = (userInput as string).toLowerCase()
+  } else {
+    q = query.toLowerCase()
+  }
+  
+  const matchedCollections = Object.keys(allCollections).filter(c => c.toLowerCase().includes(q))
+  if (matchedCollections.length > 0) {
+    p.log.success('📚 Collections found:')
+    for (const c of matchedCollections) {
+      p.log.message(`  - ${c} (${allCollections[c].length} skills) -> \`npx devskill install ${c}\``)
+    }
+  } else if (q) {
+    p.log.warn('No collections found matching query')
+  }
+
+  const matchedSkills = allSkills.filter(s => s.toLowerCase().includes(q))
+  if (matchedSkills.length > 0) {
+    p.log.success('🛠️  Individual Skills found:')
+    for (const s of matchedSkills) {
+      p.log.message(`  - ${s} -> \`npx devskill add ${s}\``)
+    }
+  } else if (q) {
+    p.log.warn('No individual skills found matching query')
+  }
+}
+
 async function main() {
   const args = process.argv.slice(2)
   const skipPrompt = args.includes('-y') || args.includes('--yes')
-  const command = args.find(arg => !arg.startsWith('-'))
+  
+  const positionalArgs = args.filter(arg => !arg.startsWith('-'))
+  const command = positionalArgs[0]
+  const targetNames = positionalArgs.slice(1)
+  const targetName = targetNames[0] // for finding
+
+  if (command === 'find') {
+    await findSkills(targetName)
+    p.outro('Done')
+    return
+  }
 
   if (command === 'init') {
     p.intro('Skills Manager - Init')
@@ -646,22 +769,24 @@ async function main() {
   }
 
   if (command === 'install') {
-    p.intro('Skills Manager - Install Groups')
-    await installSkills()
+    const namesJoined = targetNames.length > 0 ? ` (${targetNames.join(', ')})` : ''
+    p.intro(`Skills Manager - Install Groups${namesJoined}`)
+    await installSkills(targetNames)
     p.outro('Done')
     return
   }
 
   if (command === 'add') {
-    p.intro('Skills Manager - Add Specific Skills')
-    await installSpecificSkills()
+    const namesJoined = targetNames.length > 0 ? ` (${targetNames.join(', ')})` : ''
+    p.intro(`Skills Manager - Add Specific Skills${namesJoined}`)
+    await installSpecificSkills(targetNames)
     p.outro('Done')
     return
   }
 
   if (skipPrompt) {
     p.log.error('Command required when using -y flag')
-    p.log.info('Available commands: install, add, init, sync, check, cleanup')
+    p.log.info('Available commands: find, install, add, init, sync, check, cleanup')
     process.exit(1)
   }
 
@@ -672,6 +797,7 @@ async function main() {
     options: [
       { value: 'install', label: 'Install collections', hint: 'Copy entire skill collections to a local project' },
       { value: 'add', label: 'Add specific skills', hint: 'Choose individual skills to add to your project' },
+      { value: 'find', label: 'Find a skill or collection', hint: 'Search by keyword' },
       { value: 'sync', label: 'Sync submodules', hint: 'Pull latest and sync Type 2 skills' },
       { value: 'init', label: 'Init submodules', hint: 'Add new submodules from meta.ts' },
       { value: 'check', label: 'Check updates', hint: 'See available updates' },
@@ -691,6 +817,9 @@ async function main() {
     case 'add':
       await installSpecificSkills()
       break
+    case 'find':
+      await findSkills()
+      break
     case 'init':
       await initSubmodules()
       break