spirewise 1.0.1 → 1.0.3

package/bin/cli.js

@@ -27,15 +27,60 @@ const PKG_ROOT = path.resolve(__dirname, '..');
 const SKILLS_DIR = path.join(PKG_ROOT, 'skills');
 const HOME = process.env.HOME || process.env.USERPROFILE || os.homedir();
 
-const c = {
-  reset: '\x1b[0m', blue: '\x1b[1;34m', green: '\x1b[1;32m',
-  yellow: '\x1b[1;33m', red: '\x1b[1;31m', dim: '\x1b[2m',
+const USE_COLOR = !process.env.NO_COLOR;
+const RAW = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  blue: '\x1b[1;34m', green: '\x1b[1;32m', yellow: '\x1b[1;33m',
+  red: '\x1b[1;31m', cyan: '\x1b[1;36m', magenta: '\x1b[1;35m',
 };
+const paint = (code, s) => (USE_COLOR ? `${code}${s}${RAW.reset}` : s);
+const c = USE_COLOR
+  ? RAW
+  : { reset: '', bold: '', dim: '', blue: '', green: '', yellow: '', red: '', cyan: '', magenta: '' };
+
 const info = (m) => console.log(`${c.blue}==>${c.reset} ${m}`);
 const ok = (m) => console.log(`${c.green} ok${c.reset} ${m}`);
 const warn = (m) => console.error(`${c.yellow}  !${c.reset} ${m}`);
 const die = (m) => { console.error(`${c.red}err${c.reset} ${m}`); process.exit(1); };
 
+let PKG_VERSION = '';
+try { PKG_VERSION = require(path.join(PKG_ROOT, 'package.json')).version || ''; } catch (_) {}
+
+const BANNER = [
+  '   ███████╗██████╗ ██╗██████╗ ███████╗██╗    ██╗██╗███████╗███████╗',
+  '   ██╔════╝██╔══██╗██║██╔══██╗██╔════╝██║    ██║██║██╔════╝██╔════╝',
+  '   ███████╗██████╔╝██║██████╔╝█████╗  ██║ █╗ ██║██║███████╗█████╗  ',
+  '   ╚════██║██╔═══╝ ██║██╔══██╗██╔══╝  ██║███╗██║██║╚════██║██╔══╝  ',
+  '   ███████║██║     ██║██║  ██║███████╗╚███╔███╔╝██║███████║███████╗',
+  '   ╚══════╝╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝ ╚══╝╚══╝ ╚═╝╚══════╝╚══════╝',
+];
+
+function banner() {
+  console.log('');
+  for (const line of BANNER) console.log(paint(RAW.cyan, line));
+  const tag = `   Agent Skills · F6S & LinkedIn copywriting${PKG_VERSION ? '  ·  v' + PKG_VERSION : ''}`;
+  console.log(paint(RAW.magenta, tag));
+  console.log('');
+}
+
+let STEP_TOTAL = 4;
+function step(n, msg) {
+  console.log(`${paint(RAW.cyan, '  ▸')} ${paint(RAW.bold, `Step ${n}/${STEP_TOTAL}`)}  ${msg}`);
+}
+function substep(msg) {
+  console.log(`      ${paint(RAW.green, '✓')} ${msg}`);
+}
+
+function box(lines) {
+  const vis = (s) => s.replace(/\x1b\[[0-9;]*m/g, '');
+  const width = Math.max(...lines.map((l) => vis(l).length));
+  const top = '  ┌' + '─'.repeat(width + 2) + '┐';
+  const bot = '  └' + '─'.repeat(width + 2) + '┘';
+  console.log(paint(RAW.green, top));
+  for (const l of lines) console.log(paint(RAW.green, '  │ ') + l + ' '.repeat(width - vis(l).length) + paint(RAW.green, ' │'));
+  console.log(paint(RAW.green, bot));
+}
+
 /**
  * Agent registry. `format`:
  *   - 'skill': copy the skill folder verbatim (SKILL.md + any files)
@@ -120,13 +165,13 @@ function installToAgent(agentKey, agent, scope, skills) {
     if (agent.format === 'skill') {
       const dest = path.join(targetDir, skill);
       copyDir(path.join(SKILLS_DIR, skill), dest);
-      ok(`${agent.label} ${c.dim}(${scope})${c.reset} ${skill} ${c.dim}-> ${dest}${c.reset}`);
+      console.log(`      ${paint(RAW.green, '✓')} ${paint(RAW.bold, agent.label)} ${c.dim}(${scope})${c.reset} ${skill} ${c.dim}→ ${dest}${c.reset}`);
     } else {
       const { description, body } = readSkill(skill);
       const front = `---\ndescription: ${description}\nalwaysApply: false\n---\n\n`;
       const file = path.join(targetDir, skill + (agent.ext || '.md'));
       fs.writeFileSync(file, front + body);
-      ok(`${agent.label} ${c.dim}(${scope})${c.reset} ${skill} ${c.dim}-> ${file}${c.reset}`);
+      console.log(`      ${paint(RAW.green, '✓')} ${paint(RAW.bold, agent.label)} ${c.dim}(${scope})${c.reset} ${skill} ${c.dim}→ ${file}${c.reset}`);
     }
   }
 }
@@ -229,28 +274,40 @@ async function main() {
 
   const o = parseArgs(argv);
 
+  banner();
+
+  step(1, 'Scanning available skills');
+  let skills = o.skills.length ? o.skills : available.slice();
+  for (const s of skills) if (!available.includes(s)) die(`Unknown skill '${s}'. Run "spirewise list".`);
+  substep(`${skills.length} skill(s): ${skills.join(', ')}`);
+
+  step(2, 'Selecting target agents');
   let agentKeys = Object.keys(AGENTS);
   if (o.agents) {
     for (const k of o.agents) if (!AGENTS[k]) die(`Unknown agent '${k}'. Run "spirewise agents".`);
     agentKeys = o.agents;
   }
+  substep(`${agentKeys.length} agent(s): ${agentKeys.join(', ')}`);
 
-  let skills = o.skills.length ? o.skills : available.slice();
-  for (const s of skills) if (!available.includes(s)) die(`Unknown skill '${s}'. Run "spirewise list".`);
-
+  step(3, 'Choosing install scope');
   let scope = o.scope || await promptScope();
   if (!['project', 'global', 'both'].includes(scope)) die(`Invalid scope '${scope}'.`);
   const scopes = scope === 'both' ? ['project', 'global'] : [scope];
+  substep(`scope: ${paint(RAW.bold, scope === 'project' ? 'workspace' : scope)}`);
 
-  info(`Installing ${skills.length} skill(s) into ${agentKeys.length} agent(s): ${agentKeys.join(', ')}`);
-  info(`Scope: ${scope}`);
-
+  step(4, 'Installing');
+  let count = 0;
   for (const sc of scopes) {
-    for (const k of agentKeys) installToAgent(k, AGENTS[k], sc, skills);
+    for (const k of agentKeys) { installToAgent(k, AGENTS[k], sc, skills); count += skills.length; }
   }
 
-  ok(`Done. ${skills.length} skill(s) -> ${agentKeys.length} agent(s) (${scopes.join(' + ')}).`);
-  info('Restart your agent or reload skills/rules if needed.');
+  console.log('');
+  box([
+    `Installed ${paint(RAW.bold, String(skills.length))} skill(s) into ${paint(RAW.bold, String(agentKeys.length))} agent(s)`,
+    `scope: ${scopes.map((s) => (s === 'project' ? 'workspace' : s)).join(' + ')}   ·   ${count} item(s) written`,
+    `next: open your agent and say "write our F6S profile copy"`,
+  ]);
+  console.log('');
 }
 
 main().catch((e) => die(e && e.message ? e.message : String(e)));

package/install.sh

@@ -37,6 +37,19 @@ info()  { printf '%s %s\n' "$(color '1;34' '==>')" "$1"; }
 ok()    { printf '%s %s\n' "$(color '1;32' ' ok')" "$1"; }
 warn()  { printf '%s %s\n' "$(color '1;33' '  !')" "$1" >&2; }
 die()   { printf '%s %s\n' "$(color '1;31' 'err')" "$1" >&2; exit 1; }
+step()  { printf '%s %s  %s\n' "$(color '1;36' '  >')" "$(color '1' "Step $1/4")" "$2"; }
+substep() { printf '      %s %s\n' "$(color '1;32' 'v')" "$1"; }
+
+banner() {
+  printf '\n'
+  color '1;36' '   ███████╗██████╗ ██╗██████╗ ███████╗██╗    ██╗██╗███████╗███████╗'; printf '\n'
+  color '1;36' '   ██╔════╝██╔══██╗██║██╔══██╗██╔════╝██║    ██║██║██╔════╝██╔════╝'; printf '\n'
+  color '1;36' '   ███████╗██████╔╝██║██████╔╝█████╗  ██║ █╗ ██║██║███████╗█████╗  '; printf '\n'
+  color '1;36' '   ╚════██║██╔═══╝ ██║██╔══██╗██╔══╝  ██║███╗██║██║╚════██║██╔══╝  '; printf '\n'
+  color '1;36' '   ███████║██║     ██║██║  ██║███████╗╚███╔███╔╝██║███████║███████╗'; printf '\n'
+  color '1;36' '   ╚══════╝╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝ ╚══╝╚══╝ ╚═╝╚══════╝╚══════╝'; printf '\n'
+  color '1;35' '   Agent Skills · F6S & LinkedIn copywriting'; printf '\n\n'
+}
 
 usage() {
   cat <<EOF
@@ -148,13 +161,13 @@ install_for_agent() {
     if [[ "$fmt" == "skill" ]]; then
       mkdir -p "$dir/$s"
       cp -R "$base/$s/." "$dir/$s/"
-      ok "$label ($scope) $s -> $dir/$s"
+      substep "$label ($scope) $s -> $dir/$s"
     else
       local desc body file
       desc="$(skill_description "$base/$s/SKILL.md")"
       file="$dir/$s$ext"
       { printf -- '---\ndescription: %s\nalwaysApply: false\n---\n\n' "$desc"; skill_body "$base/$s/SKILL.md"; } >"$file"
-      ok "$label ($scope) $s -> $file"
+      substep "$label ($scope) $s -> $file"
     fi
   done
 }
@@ -187,14 +200,23 @@ if $DO_LIST; then
   info "Available skills:"; printf '  - %s\n' "${AVAILABLE[@]}"; exit 0
 fi
 
-# Skills: default all.
+banner
+
+# Step 1: skills (default all).
+step 1 "Scanning available skills"
 [[ ${#SELECTED[@]} -eq 0 ]] && SELECTED=("${AVAILABLE[@]}")
 for s in "${SELECTED[@]}"; do
   found=false; for a in "${AVAILABLE[@]}"; do [[ "$s" == "$a" ]] && found=true && break; done
   $found || die "Unknown skill '$s'. Use --list."
 done
+substep "${#SELECTED[@]} skill(s): ${SELECTED[*]}"
+
+# Step 2: agents
+step 2 "Selecting target agents"
+if [[ -n "$AGENT_FILTER" ]]; then substep "agents: $AGENT_FILTER"; else substep "agents: all supported"; fi
 
-# Scope: prompt if not given.
+# Step 3: scope — prompt if not given.
+step 3 "Choosing install scope"
 if [[ -z "$SCOPE" ]]; then
   if [[ -t 0 ]]; then
     info "Where should the skills be installed?"
@@ -209,11 +231,12 @@ if [[ -z "$SCOPE" ]]; then
     SCOPE="project"
   fi
 fi
+[[ "$SCOPE" == "project" ]] && substep "scope: workspace" || substep "scope: $SCOPE"
 
 SCOPES=("$SCOPE"); [[ "$SCOPE" == "both" ]] && SCOPES=("project" "global")
 
-info "Installing ${#SELECTED[@]} skill(s) into all matching agents. Scope: $SCOPE"
-
+# Step 4: install
+step 4 "Installing"
 for sc in "${SCOPES[@]}"; do
   for entry in "${AGENTS[@]}"; do
     IFS='|' read -r key label fmt ext pdir gdir <<<"$entry"
@@ -225,5 +248,6 @@ for sc in "${SCOPES[@]}"; do
   done
 done
 
-ok "Done."
-info "Restart your agent or reload skills/rules if needed."
+printf '\n'
+ok "Installed ${#SELECTED[@]} skill(s). Next: open your agent and say \"write our F6S profile copy\"."
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spirewise",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Installable Agent Skills for copywriting (F6S & LinkedIn company pages) for GitHub Copilot, Claude Code, and Cursor.",
   "bin": {
     "spirewise": "bin/cli.js"

package/skills/f6s-copywriting/SKILL.md

@@ -2,10 +2,12 @@
 name: f6s-copywriting
 description: >-
   Generate complete, ready-to-paste copywriting for an F6S (f6s.com) startup/company
-  profile page. Use when the user asks to "write our F6S profile", "create F6S
-  copy", "fill out F6S page", or prepare content for an accelerator / investor
-  application on F6S. Produces a single .txt file under an `f6s/` folder in the
-  project root, with every field kept STRICTLY under its character limit.
+  profile page, written like a senior unicorn-startup marketer — humanized,
+  attention-grabbing, and conversion-focused. Use when the user asks to "write our
+  F6S profile", "create F6S copy", "fill out F6S page", or prepare content for an
+  accelerator / investor application on F6S. Produces a single .txt file under an
+  `f6s/` folder in the project root, with every field kept STRICTLY under its
+  character limit.
 ---
 
 # F6S Profile Copywriting
@@ -69,6 +71,49 @@ keep the same "stay under" headroom rule.
 - Write in third person or first-person plural ("we") consistently.
 - No keyword stuffing; F6S profiles are read by humans (accelerators/investors).
 
+## Voice & quality standard — write like a unicorn-startup marketer
+
+Write every word as if you are a **senior brand + growth marketer who has led
+messaging for category-defining startups** (think the caliber of Stripe, Notion,
+Linear, Ramp, Airbnb). The copy an accelerator partner or investor reads should
+feel sharp, confident, and unmistakably human. Non-negotiable bar:
+
+**1. Humanized — sounds like a real person, never "AI-generated".**
+- Vary sentence length. Mix short, punchy lines with one longer, rhythmic one.
+- Use plain, concrete language a smart 12-year-old could follow. Cut jargon.
+- Write with a point of view and a pulse — confident, not corporate-bland.
+- Read it aloud in your head; if a sentence sounds robotic, rewrite it.
+
+**2. Banned "AI tells" — never use these.**
+- Filler verbs/phrases: "leverage", "utilize", "seamlessly", "robust",
+  "cutting-edge", "state-of-the-art", "empower", "unlock", "elevate",
+  "revolutionize", "game-changer", "in today's fast-paced world",
+  "we are committed to", "at the intersection of".
+- Hype with no proof: "best", "#1", "world-class", "industry-leading".
+- Em-dash overuse, three-item lists on autopilot, and symmetrical "not only…
+  but also" scaffolding. Break the pattern; write like a human, not a template.
+
+**3. Attracting & focused — earn the next 5 seconds of attention.**
+- Hook first. The opening line must make the reader want the next one.
+- One core idea per field. If it does two jobs, split or cut.
+- Specific > vague every time: real numbers, named customers, concrete outcomes.
+  "Cut onboarding from 3 weeks to 2 days for 40+ teams" beats "improves
+  efficiency".
+- Lead with the customer's problem and the outcome, not your feature list.
+- Active voice, present tense, strong verbs. Subject does the thing.
+
+**4. Investor/accelerator lens (this is F6S).**
+- Make the *why now*, the *traction*, and the *wedge* obvious fast.
+- Show momentum with evidence (growth %, revenue, retention, logos, waitlist).
+- Sound fundable and grounded — ambitious vision backed by real proof.
+
+**5. Final humanization pass (always run before saving).**
+- Remove every banned word above; replace with plain, specific language.
+- Delete adjectives that aren't earned by a fact.
+- Tighten: if a word can be cut without losing meaning, cut it.
+- Ensure no two consecutive sentences share the same shape or opener.
+- Confirm it reads like one confident human voice end to end.
+
 ## Required .txt output template
 
 Write the file using exactly this structure. Put the live character count in
@@ -130,3 +175,5 @@ Other: <url>
 3. No field is empty unless intentionally a `[PLACEHOLDER]`.
 4. No banned hype words; tone is factual and specific.
 5. Confirm counts programmatically (e.g. `awk`/`wc -m` per field) — do not trust eyeballing.
+6. Humanization pass done: zero banned "AI tells", varied sentence shapes, reads
+   like one confident human marketer wrote it, and every claim is specific.

package/skills/linkedin-copywriting/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: linkedin-copywriting
 description: >-
-  Generate complete, ready-to-paste copywriting for a LinkedIn Company Page.
-  Use when the user asks to "write our LinkedIn page", "create LinkedIn company
-  copy", "fill out the About section", or prepare LinkedIn page content. Produces
-  a single .txt file under a `linkedin copywriting/` folder in the project root,
-  with every field kept STRICTLY under its character limit.
+  Generate complete, ready-to-paste copywriting for a LinkedIn Company Page,
+  written like a senior unicorn-startup marketer — humanized, attention-grabbing,
+  and conversion-focused. Use when the user asks to "write our LinkedIn page",
+  "create LinkedIn company copy", "fill out the About section", or prepare LinkedIn
+  page content. Produces a single .txt file under a `linkedin copywriting/` folder
+  in the project root, with every field kept STRICTLY under its character limit.
 ---
 
 # LinkedIn Company Page Copywriting
@@ -68,6 +69,50 @@ the same "stay under" headroom rule.
 - Tone: professional, confident, specific. Avoid empty hype.
 - End the About section with a clear next step (visit site, follow, contact).
 
+## Voice & quality standard — write like a unicorn-startup marketer
+
+Write every word as if you are a **senior brand + growth marketer who has led
+messaging for category-defining startups** (think the caliber of Stripe, Notion,
+Linear, Ramp, Airbnb). The page should feel sharp, confident, and unmistakably
+human — like a person customers and recruiters *want* to follow. Non-negotiable:
+
+**1. Humanized — sounds like a real person, never "AI-generated".**
+- Vary sentence length. Mix short, punchy lines with one longer, rhythmic one.
+- Plain, concrete language a smart 12-year-old could follow. Cut jargon.
+- Write with a point of view and a pulse — confident, not corporate-bland.
+- Read it aloud in your head; if a sentence sounds robotic, rewrite it.
+
+**2. Banned "AI tells" — never use these.**
+- Filler: "leverage", "utilize", "seamlessly", "robust", "cutting-edge",
+  "state-of-the-art", "empower", "unlock", "elevate", "revolutionize",
+  "game-changer", "in today's fast-paced world", "we are committed to",
+  "passionate about", "at the intersection of", "solutions provider".
+- Hype with no proof: "best", "#1", "world-class", "industry-leading".
+- Em-dash overuse, robotic three-item lists, and "not only… but also"
+  scaffolding. Break the pattern; write like a human, not a template.
+
+**3. Attracting & focused — earn the next 5 seconds of attention.**
+- The first ~150 chars of About are the hook shown before "see more" — make them
+  a magnetic, standalone value statement, not a throat-clearing intro.
+- One core idea per section. Specific > vague every time: real numbers, named
+  customers, concrete outcomes. "Helps 12,000 founders raise faster" beats
+  "provides solutions for startups".
+- Lead with the reader's problem and the outcome, then how you deliver it.
+- Active voice, present tense, strong verbs. Subject does the thing.
+
+**4. LinkedIn lens (humans + search).**
+- Weave the terms customers/recruiters/partners actually search — naturally,
+  never stuffed. Keywords serve the sentence, not the other way around.
+- Tagline = benefit- or category-led with a real hook, not a hollow slogan.
+- Close About with one clear next step (follow, visit site, get in touch).
+
+**5. Final humanization pass (always run before saving).**
+- Remove every banned word above; replace with plain, specific language.
+- Delete adjectives that aren't earned by a fact.
+- Tighten: if a word can be cut without losing meaning, cut it.
+- Ensure no two consecutive sentences share the same shape or opener.
+- Confirm it reads like one confident human voice end to end.
+
 ## Required .txt output template
 
 Write the file using exactly this structure. Put the live character count in
@@ -118,3 +163,5 @@ Generated: <YYYY-MM-DD>
 3. Specialties: ≤ 20 items, each ≤ 28 chars.
 4. About section's first ~150 chars work as a standalone preview hook.
 5. Confirm counts programmatically (e.g. `awk`/`wc -m` per field) — do not trust eyeballing.
+6. Humanization pass done: zero banned "AI tells", varied sentence shapes, reads
+   like one confident human marketer wrote it, and every claim is specific.