skillflow-ai 0.1.0 → 0.2.0

package/README.md

@@ -25,6 +25,9 @@ npx skillflow-ai add <slug> --agent codex     # into ~/.codex/skills
 npx skillflow-ai add <slug> --project         # into ./.claude/skills of this folder
 npx skillflow-ai add <slug> --dir <folder>    # any folder (Antigravity and others)
 npx skillflow-ai update                       # update everything you installed
+npx skillflow-ai themes                       # colour themes for the result
+npx skillflow-ai add <slug> --theme hijau-daun  # result in that theme (THEME.md in the skill)
+npx skillflow-ai add <slug> --colors "#1F5E3B,#F2B33D"  # or your own two colours
 npx skillflow-ai remove <slug>
 npx skillflow-ai whoami
 npx skillflow-ai logout

package/bin/skillflow.mjs

@@ -36,7 +36,7 @@ function parse(argv) {
     if (a.startsWith('--')) {
       const [k, v] = a.slice(2).split('=')
       if (v !== undefined) opts[k] = v
-      else if (argv[i + 1] && !argv[i + 1].startsWith('-') && ['agent', 'dir', 'server', 'kind', 'token'].includes(k)) opts[k] = argv[++i]
+      else if (argv[i + 1] && !argv[i + 1].startsWith('-') && ['agent', 'dir', 'server', 'kind', 'token', 'theme', 'colors'].includes(k)) opts[k] = argv[++i]
       else opts[k] = true
     } else if (a === '-h') opts.help = true
     else args.push(a)
@@ -76,9 +76,25 @@ function targetDir(opts) {
   return AGENTS[agent]
 }
 
-async function install(slug, dir) {
+// Colour theme of the result, sent as the same `?tema=` the directory's ZIP link uses. undefined = not given,
+// '' = no theme (the skill's own colours; also how --theme default clears a saved one).
+function themeQuery(opts) {
+  if (opts.colors && opts.colors !== true) {
+    const c = String(opts.colors).split(',').map(s => s.trim())
+    if (c.length !== 2 || !c.every(x => /^#?[0-9a-fA-F]{6}$/.test(x))) fail('--colors takes two hex colours: --colors "#1F5E3B,#F2B33D"')
+    const hex = c.map(x => (x.startsWith('#') ? x : '#' + x).toUpperCase())
+    return `?tema=custom&utama=${encodeURIComponent(hex[0])}&aksen=${encodeURIComponent(hex[1])}`
+  }
+  if (opts.theme === undefined) return undefined
+  if (opts.theme === true) fail('Name a theme: --theme <name> (see: npx skillflow-ai themes)')
+  if (['default', 'none'].includes(opts.theme)) return ''
+  if (!/^[a-z-]{1,40}$/.test(opts.theme)) fail(`"${opts.theme}" is not a theme name. See: npx skillflow-ai themes`)
+  return `?tema=${opts.theme}`
+}
+
+async function install(slug, dir, theme = '') {
   if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug)) fail(`"${slug}" is not a skill name.`)
-  const { buf, version } = await api(`/api/skills/v1/skills/${slug}/bundle`, { raw: true })
+  const { buf, version } = await api(`/api/skills/v1/skills/${slug}/bundle${theme}`, { raw: true })
   const entries = readZip(buf)
   // Bundles hold "<slug>/…". Anything outside that folder is ignored.
   const own = entries.filter(e => e.name === slug + '/' || e.name.startsWith(slug + '/'))
@@ -98,7 +114,7 @@ async function install(slug, dir) {
   rmSync(final, { recursive: true, force: true })
   renameSync(tmp, final)
   const list = readJson(INSTALLED, {})
-  list[final] = { slug, version: version || null, dir, at: new Date().toISOString() }
+  list[final] = { slug, version: version || null, dir, theme: theme || null, at: new Date().toISOString() }
   writePrivate(INSTALLED, list)
   return { final, version }
 }
@@ -109,10 +125,13 @@ const HELP = `skillflow ${VERSION}: install SkillFlow skills into your AI agent
   npx skillflow-ai whoami                                who the token belongs to
   npx skillflow-ai list [--kind video]                   skills you can install
   npx skillflow-ai add <slug> [<slug>…]                  install into ~/.claude/skills
+        --theme <name> | --colors "#hex,#hex"            colour theme of the result (THEME.md)
         --agent codex                                    ~/.codex/skills instead
         --project                                        ./.claude/skills (or ./.codex/skills) in this folder
         --dir <folder>                                   any folder (Antigravity and other agents)
   npx skillflow-ai update [<slug>]                       update installed skills to the latest version
+        --theme <name> | --colors … | --theme default    change the colour theme while updating
+  npx skillflow-ai themes                                list the colour themes
   npx skillflow-ai remove <slug> [--dir <folder>]        delete an installed skill
   npx skillflow-ai logout                                forget the token on this computer
 `
@@ -153,8 +172,9 @@ async function main() {
     case 'add': {
       if (!args.length) fail('Name a skill: npx skillflow-ai add <slug>')
       const dir = targetDir(opts)
+      const theme = themeQuery(opts) ?? ''
       for (const slug of args) {
-        const r = await install(slug, dir)
+        const r = await install(slug, dir, theme)
         say(`✓ ${slug}${r.version ? ' v' + r.version : ''} → ${r.final}`)
       }
       break
@@ -165,16 +185,27 @@ async function main() {
       if (!want.length) { say('Nothing installed yet.'); break }
       const { skills } = await api('/api/skills/v1/catalog')
       const latest = Object.fromEntries(skills.map(s => [s.slug, s.version]))
+      // The theme a skill was installed with is kept; --theme / --colors replaces it (and reinstalls).
+      const given = themeQuery(opts)
       let n = 0
       for (const [, r] of want) {
         if (!latest[r.slug]) { say(`- ${r.slug}: no longer in the catalog (left as it is)`); continue }
-        if (latest[r.slug] === r.version && !opts.force) continue
-        const res = await install(r.slug, r.dir)
+        const theme = given ?? (r.theme || '')
+        if (latest[r.slug] === r.version && !opts.force && theme === (r.theme || '')) continue
+        const res = await install(r.slug, r.dir, theme)
         say(`✓ ${r.slug} ${r.version || '?'} → ${res.version || latest[r.slug]}`); n++
       }
       say(n ? `${n} skill(s) updated.` : 'Everything is up to date.')
       break
     }
+    case 'themes': {
+      const { themes } = await api('/api/skills/v1/catalog')
+      if (!themes || !themes.length) { say('This directory has no colour themes yet.'); break }
+      for (const t of themes) say('  ' + t)
+      say('\nUse one with: npx skillflow-ai add <slug> --theme ' + themes[0])
+      say('Or your own two colours: --colors "#1F5E3B,#F2B33D". Without either, the skill keeps its own colours.')
+      break
+    }
     case 'remove': {
       if (!args.length) fail('Name a skill: npx skillflow-ai remove <slug>')
       const list = readJson(INSTALLED, {})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillflow-ai",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install SkillFlow AI skills into Claude Code, Codex or any agent folder with one command.",
   "type": "module",
   "bin": { "skillflow-ai": "bin/skillflow.mjs", "skillflow": "bin/skillflow.mjs" },