@take-out/cli 0.1.11 → 0.1.13

package/src/cli.ts

@@ -84,6 +84,7 @@ if (isShorthand) {
     'run',
     'run-all',
     'script',
+    'skills',
     'env:setup',
     'sync',
     'changed',
@@ -153,6 +154,7 @@ const main = defineCommand({
     run: () => import('./commands/run').then((m) => m.runCommand),
     'run-all': () => import('./commands/run-all').then((m) => m.runAllCommand),
     script: () => import('./commands/script').then((m) => m.scriptCommand),
+    skills: () => import('./commands/skills').then((m) => m.skillsCommand),
     sync: () => import('./commands/sync').then((m) => m.syncCommand),
     changed: () => import('./commands/changed').then((m) => m.changedCommand),
   },

package/src/commands/docs.ts

@@ -2,19 +2,9 @@
  * Docs command - list and retrieve documentation files from the package
  */
 
-import {
-  existsSync,
-  lstatSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  rmSync,
-  symlinkSync,
-  unlinkSync,
-  writeFileSync,
-} from 'node:fs'
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
-import { dirname, join, relative } from 'node:path'
+import { dirname, join } from 'node:path'
 
 import { defineCommand } from 'citty'
 import pc from 'picocolors'
@@ -313,281 +303,6 @@ const ejectCommand = defineCommand({
   },
 })
 
-// check if content has yaml frontmatter with required skill fields
-function hasSkillFrontmatter(content: string): boolean {
-  if (!content.startsWith('---')) return false
-  const endIndex = content.indexOf('---', 3)
-  if (endIndex === -1) return false
-
-  const frontmatter = content.slice(3, endIndex)
-  return frontmatter.includes('name:') && frontmatter.includes('description:')
-}
-
-// check if content has dev: true in frontmatter
-function isDevOnly(content: string): boolean {
-  if (!content.startsWith('---')) return false
-  const endIndex = content.indexOf('---', 3)
-  if (endIndex === -1) return false
-
-  const frontmatter = content.slice(3, endIndex)
-  return /\bdev:\s*true\b/.test(frontmatter)
-}
-
-// extract title and description from markdown content (for docs without frontmatter)
-function extractDocMeta(content: string): { title: string; description: string } {
-  const lines = content.split('\n')
-  let title = ''
-  let description = ''
-
-  // skip frontmatter if present
-  let startLine = 0
-  if (lines[0]?.trim() === '---') {
-    for (let i = 1; i < lines.length; i++) {
-      if (lines[i]?.trim() === '---') {
-        startLine = i + 1
-        break
-      }
-    }
-  }
-
-  for (let i = startLine; i < lines.length; i++) {
-    const trimmed = lines[i]?.trim() || ''
-    // first h1 heading is the title
-    if (!title && trimmed.startsWith('# ')) {
-      title = trimmed.slice(2).trim()
-      continue
-    }
-    // first non-empty, non-heading line after title is description
-    if (title && trimmed && !trimmed.startsWith('#')) {
-      description = trimmed
-      break
-    }
-  }
-
-  return { title, description }
-}
-
-// convert doc name to skill-friendly name (lowercase, hyphens)
-function toSkillName(name: string): string {
-  return name
-    .toLowerCase()
-    .replace(/[^a-z0-9-]/g, '-')
-    .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '')
-    .slice(0, 64)
-}
-
-// collect all docs from both package and local directories
-function collectAllDocs(
-  cwd: string
-): Array<{ name: string; path: string; source: 'package' | 'local' }> {
-  const docs: Array<{ name: string; path: string; source: 'package' | 'local' }> = []
-  const seen = new Set<string>()
-
-  // local docs override package docs
-  const localDocsDir = join(cwd, 'docs')
-  if (existsSync(localDocsDir)) {
-    const files = readdirSync(localDocsDir).filter((f) => f.endsWith('.md'))
-    for (const file of files) {
-      const name = file.replace(/\.md$/, '')
-      docs.push({ name, path: join(localDocsDir, file), source: 'local' })
-      seen.add(name)
-    }
-  }
-
-  // package docs (only if not overridden by local)
-  if (existsSync(DOCS_DIR)) {
-    const files = readdirSync(DOCS_DIR).filter((f) => f.endsWith('.md'))
-    for (const file of files) {
-      const name = file.replace(/\.md$/, '')
-      if (!seen.has(name)) {
-        docs.push({ name, path: join(DOCS_DIR, file), source: 'package' })
-      }
-    }
-  }
-
-  return docs
-}
-
-const SKILL_PREFIX = 'takeout-'
-
-const skillsCommand = defineCommand({
-  meta: {
-    name: 'skills',
-    description: 'Generate Claude Code skills from documentation',
-  },
-  args: {
-    clean: {
-      type: 'boolean',
-      description: 'Remove existing skills before generating',
-      default: false,
-    },
-  },
-  async run({ args }) {
-    const cwd = process.cwd()
-    const skillsDir = join(cwd, '.claude', 'skills')
-
-    console.info()
-    console.info(pc.bold(pc.cyan('🧠 Generate Claude Code Skills')))
-    console.info()
-
-    // collect all docs
-    const docs = collectAllDocs(cwd)
-
-    if (docs.length === 0) {
-      console.info(pc.yellow('No documentation files found'))
-      return
-    }
-
-    console.info(pc.dim(`Found ${docs.length} documentation files`))
-    console.info()
-
-    // clean existing takeout skills if requested
-    if (args.clean && existsSync(skillsDir)) {
-      console.info(pc.yellow('Cleaning existing takeout skills...'))
-      const existing = readdirSync(skillsDir)
-      for (const dir of existing) {
-        if (dir.startsWith(SKILL_PREFIX)) {
-          rmSync(join(skillsDir, dir), { recursive: true })
-        }
-      }
-    }
-
-    // ensure skills directory exists
-    if (!existsSync(skillsDir)) {
-      mkdirSync(skillsDir, { recursive: true })
-    }
-
-    let symlinked = 0
-    let generated = 0
-    let unchanged = 0
-
-    const isDev = !!process.env.IS_TAMAGUI_DEV
-
-    for (const doc of docs) {
-      // read doc content
-      const content = readFileSync(doc.path, 'utf-8')
-
-      // skip dev-only docs unless IS_TAMAGUI_DEV is set
-      if (isDevOnly(content) && !isDev) continue
-
-      const hasFrontmatter = hasSkillFrontmatter(content)
-
-      if (hasFrontmatter) {
-        // extract skill name from frontmatter
-        const nameMatch = content.match(/^---\s*\nname:\s*([^\n]+)/m)
-        if (!nameMatch) continue
-
-        const skillName = nameMatch[1]!.trim()
-        const skillDir = join(skillsDir, skillName)
-        const skillFile = join(skillDir, 'SKILL.md')
-
-        // ensure skill directory exists
-        if (!existsSync(skillDir)) {
-          mkdirSync(skillDir, { recursive: true })
-        }
-
-        // symlink it directly
-        const relativePath = relative(skillDir, doc.path)
-
-        // check if something exists at the skill path (including broken symlinks)
-        let shouldCreate = true
-        try {
-          const stat = lstatSync(skillFile)
-          if (stat.isSymbolicLink() && existsSync(skillFile)) {
-            // valid symlink - check if content matches
-            const existingContent = readFileSync(skillFile, 'utf-8')
-            if (existingContent === content) {
-              unchanged++
-              shouldCreate = false
-            }
-          }
-          if (shouldCreate) {
-            // remove existing file/symlink to recreate
-            unlinkSync(skillFile)
-          }
-        } catch {
-          // nothing exists at the path
-        }
-
-        if (!shouldCreate) continue
-
-        symlinkSync(relativePath, skillFile)
-        symlinked++
-
-        const sourceLabel = doc.source === 'local' ? pc.blue('local') : pc.dim('package')
-        console.info(
-          `  ${pc.green('⟷')} ${skillName} ${sourceLabel} ${pc.dim('(symlink)')}`
-        )
-      } else {
-        // doc lacks frontmatter - generate skill file with frontmatter
-        const baseName = toSkillName(doc.name)
-        const skillName = `${SKILL_PREFIX}${baseName}`
-        const skillDir = join(skillsDir, skillName)
-        const skillFile = join(skillDir, 'SKILL.md')
-
-        // ensure skill directory exists
-        if (!existsSync(skillDir)) {
-          mkdirSync(skillDir, { recursive: true })
-        }
-
-        const { title, description } = extractDocMeta(content)
-        const skillDescription = description
-          ? `${title}. ${description}`.slice(0, 1024)
-          : title.slice(0, 1024)
-
-        const skillContent = `---
-name: ${skillName}
-description: ${skillDescription}
----
-
-${content}
-`
-
-        // check if skill already exists and is identical
-        let shouldWrite = true
-        try {
-          const stat = lstatSync(skillFile)
-          if (stat.isSymbolicLink()) {
-            // remove symlink to replace with generated file
-            unlinkSync(skillFile)
-          } else {
-            const existing = readFileSync(skillFile, 'utf-8')
-            if (existing === skillContent) {
-              unchanged++
-              shouldWrite = false
-            }
-          }
-        } catch {
-          // nothing exists at the path
-        }
-
-        if (!shouldWrite) continue
-
-        writeFileSync(skillFile, skillContent)
-        generated++
-
-        const sourceLabel = doc.source === 'local' ? pc.blue('local') : pc.dim('package')
-        console.info(
-          `  ${pc.green('✓')} ${skillName} ${sourceLabel} ${pc.dim('(generated)')}`
-        )
-      }
-    }
-
-    console.info()
-    console.info(pc.bold('Summary:'))
-    if (symlinked > 0) console.info(`  ${pc.green(`${symlinked} symlinked`)}`)
-    if (generated > 0)
-      console.info(
-        `  ${pc.yellow(`${generated} generated`)} ${pc.dim('(add frontmatter to source to enable symlink)')}`
-      )
-    if (unchanged > 0) console.info(`  ${pc.dim(`${unchanged} unchanged`)}`)
-    console.info()
-    console.info(pc.dim(`Skills in ${skillsDir}`))
-    console.info()
-  },
-})
-
 export const docsCommand = defineCommand({
   meta: {
     name: 'docs',
@@ -598,6 +313,5 @@ export const docsCommand = defineCommand({
     get: getCommand,
     path: pathCommand,
     eject: ejectCommand,
-    skills: skillsCommand,
   },
 })