skillflow-ai 0.1.0 → 0.3.0

package/README.md

@@ -25,6 +25,11 @@ 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 add <slug> --antislop=core,ui,copywriting  # Anti Slop rules in the skill (antislop/)
+npx skillflow-ai antislop                     # the Anti Slop parts
 npx skillflow-ai remove <slug>
 npx skillflow-ai whoami
 npx skillflow-ai logout
@@ -32,4 +37,6 @@ npx skillflow-ai logout
 
 If you have a brand profile on the directory, every skill you add carries it as `BRAND.md`.
 
+`--antislop` adds the [Anti Slop](https://github.com/miqdadbadjuber/anti-slop) rules (MIT) as an `antislop/` folder the skill reads before it starts. The core is always included; parts: `ui`, `copywriting`, `human`, `mobile`, `code`. `update` keeps the choice; `--antislop=off` removes it.
+
 The token stops working when your account leaves Pro, or when you revoke it on the directory.

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', 'antislop'].includes(k)) opts[k] = argv[++i]
       else opts[k] = true
     } else if (a === '-h') opts.help = true
     else args.push(a)
@@ -76,9 +76,37 @@ 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}`
+}
+
+// Anti Slop rules (antislop/ folder in the skill), sent as the same `?antislop=` the directory's ZIP link uses.
+// undefined = not given, '' = off (also how --antislop=off clears a saved choice). The core is always part of it.
+function antislopValue(opts) {
+  if (opts.antislop === undefined) return undefined
+  if (opts.antislop === true) return 'core'
+  const v = String(opts.antislop).toLowerCase().replace(/\s+/g, '')
+  if (['off', 'none', 'no'].includes(v)) return ''
+  if (!/^[a-z]+(,[a-z]+)*$/.test(v)) fail('--antislop takes parts separated by commas: --antislop=core,ui,copywriting (see: npx skillflow-ai antislop)')
+  return v
+}
+
+async function install(slug, dir, theme = '', antislop = '') {
   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 q = [theme.replace(/^\?/, ''), antislop ? 'antislop=' + encodeURIComponent(antislop) : ''].filter(Boolean).join('&')
+  const { buf, version } = await api(`/api/skills/v1/skills/${slug}/bundle${q ? '?' + q : ''}`, { 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 +126,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, antislop: antislop || null, at: new Date().toISOString() }
   writePrivate(INSTALLED, list)
   return { final, version }
 }
@@ -109,10 +137,16 @@ 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)
+        --antislop=core,ui,copywriting                   Anti Slop rules in the skill (antislop/)
         --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
+        --antislop=<parts> | --antislop=off              change the Anti Slop rules while updating
+  npx skillflow-ai themes                                list the colour themes
+  npx skillflow-ai antislop                              list the Anti Slop parts
   npx skillflow-ai remove <slug> [--dir <folder>]        delete an installed skill
   npx skillflow-ai logout                                forget the token on this computer
 `
@@ -153,8 +187,10 @@ 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) ?? ''
+      const antislop = antislopValue(opts) ?? ''
       for (const slug of args) {
-        const r = await install(slug, dir)
+        const r = await install(slug, dir, theme, antislop)
         say(`✓ ${slug}${r.version ? ' v' + r.version : ''} → ${r.final}`)
       }
       break
@@ -165,16 +201,36 @@ 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)
+      const givenAs = antislopValue(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 || '')
+        const antislop = givenAs ?? (r.antislop || '')
+        if (latest[r.slug] === r.version && !opts.force && theme === (r.theme || '') && antislop === (r.antislop || '')) continue
+        const res = await install(r.slug, r.dir, theme, antislop)
         say(`✓ ${r.slug} ${r.version || '?'} → ${res.version || latest[r.slug]}`); n++
       }
       say(n ? `${n} skill(s) updated.` : 'Everything is up to date.')
       break
     }
+    case 'antislop': {
+      const { antislop } = await api('/api/skills/v1/catalog')
+      if (!antislop || !antislop.length) { say('This directory has no Anti Slop rules yet (update the server).'); break }
+      for (const k of antislop) say('  ' + k)
+      say('\nUse with: npx skillflow-ai add <slug> --antislop=core,ui (the core is always included). Rules: https://github.com/miqdadbadjuber/anti-slop (MIT)')
+      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.3.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" },