@veyralabs/skills 0.1.0 → 0.3.0

package/README.md

@@ -1,10 +1,13 @@
-# VeyraLabs Skills
+# VeyraSkills
 
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
-[![Skills](https://img.shields.io/badge/skills-4_available-brightgreen)](#packs)
-[![Works with 30+ agents](https://img.shields.io/badge/works_with-30%2B_agents-blue)](#supported-agents)
+Skills for Claude Code and other AI coding agents. Each skill is a plain text file that teaches your agent a specialized workflow — naming, branding, website cloning, and more.
 
-A curated collection of agent skills for founders, developers, and builders. Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, and 30+ more.
+```bash
+npx @veyralabs/skills install naming-suite
+npx @veyralabs/skills install webcloner
+```
+
+Or install everything at once:
 
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh)
@@ -12,47 +15,52 @@ bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/m
 
 ---
 
-## Packs
+## Available Skills
 
-### `naming-suite` — Brand & Naming Intelligence
+### naming-suite
 
-Four skills that work together. Find names, audit brands, map competitors, generate naming guides.
+Four skills for naming products, auditing brands, mapping competitors, and building naming systems.
 
 | Skill | What it does |
 |-------|-------------|
-| [`domainforge`](./skills/domainforge/SKILL.md) | Generate and score startup names. Domain availability, social handles, trademark check, brand narrative |
-| [`brandaudit`](./skills/brandaudit/SKILL.md) | Audit an existing brand name across 8 dimensions. Severity scoring, rebrand verdict |
-| [`competitornames`](./skills/competitornames/SKILL.md) | Map the naming landscape in your market. Saturation levels, whitespace, naming brief for DomainForge |
-| [`namingguide`](./skills/namingguide/SKILL.md) | Generate a complete naming guide for a company or product line. Principles, system, dos/don'ts, approval checklist |
+| [domainforge](./skills/naming-suite/domainforge/SKILL.md) | Generate startup name candidates. Scores each on 8 factors: memorability, distinctiveness, domain availability, trademark risk, pronunciation, spelling, brandability, market fit |
+| [brandaudit](./skills/naming-suite/brandaudit/SKILL.md) | Audit an existing brand name. Returns severity scores across 8 dimensions and a rebrand verdict |
+| [competitornames](./skills/naming-suite/competitornames/SKILL.md) | Map how competitors in a market are named. Identifies saturation, naming clusters, and open whitespace |
+| [namingguide](./skills/naming-suite/namingguide/SKILL.md) | Build a naming system for a company or product line. Covers principles, naming patterns, approval criteria, and anti-patterns |
 
-**Recommended flow:**
+Works best in sequence: run `competitornames` to understand the landscape, then `domainforge` to generate names that stand out from it.
 
-```
-competitornames → domainforge
-brandaudit      → namingguide
-```
+### webcloner
+
+Clone any landing page, marketing site, portfolio, or ecommerce storefront into a pixel-accurate Next.js replica.
+
+| Skill | What it does |
+|-------|-------------|
+| [webcloner](./skills/webcloner/SKILL.md) | Six-phase visual cloning: recon with Scrapling, foundation setup, spec generation per section, parallel component build with git worktrees, assembly, and visual QA |
+
+Includes three scripts: a Scrapling-based extractor (`extract.py`), an asset downloader with WebP conversion (`download-assets.mjs`), and a side-by-side screenshot comparison tool (`compare.mjs`).
 
-Run `competitornames` first to map the competitive landscape, then `domainforge` to generate names that stand out from it. Run `brandaudit` on an existing name, `namingguide` to lock in what works.
+Works for landings, marketing sites, portfolios, and ecommerce product pages. Not designed for SaaS dashboards, auth flows, or real-time data apps.
 
 ---
 
-## Installation
+## Install
 
-### One-line
+### A specific pack or skill
 
 ```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh)
+npx @veyralabs/skills install naming-suite
+npx @veyralabs/skills install webcloner
+npx @veyralabs/skills install domainforge
 ```
 
-Installs all available skills into your current project.
-
-### Specific skill
+### All skills
 
 ```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh) --skill domainforge
+bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh)
 ```
 
-### Global install (available across all projects)
+### Global (available across all projects)
 
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh) --global
@@ -60,10 +68,10 @@ bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/m
 
 ### Manual
 
-Copy the skill folder to your agent's skills directory and restart the agent.
+Copy the skill folder into your agent's skills directory and restart the agent.
 
-| Agent | Project | Global |
-|-------|---------|--------|
+| Agent | Project skills | Global skills |
+|-------|---------------|--------------|
 | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
 | Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
 | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
@@ -72,111 +80,67 @@ Copy the skill folder to your agent's skills directory and restart the agent.
 
 ---
 
-## Usage
+## How it works
 
-Once installed, skills activate contextually — no configuration needed.
+Skills are Markdown files with a small YAML header. Claude Code reads them at startup and knows when to activate them based on what you type. No configuration, no plugins, no API keys.
 
-**DomainForge:**
 ```
-Find a domain for my new SaaS
-Name my CLI tool for environment variables
-What should I call this project?
+Find a name for my new developer tool
 ```
 
-**BrandAudit:**
-```
-Audit the brand name "Acme" for a B2B SaaS
-Is our brand name working? Company is called Vercel for analytics tools
-```
-
-**CompetitorNames:**
-```
-Map the naming landscape for developer config tools
-Who are my competitors and how are they named?
-```
-
-**NamingGuide:**
-```
-Create a naming guide for our company
-We're building a product line and need naming conventions
-Our feature naming is inconsistent — generate a guide
-```
+That's enough to activate `domainforge`. The skill takes over from there.
 
 ---
 
-## Example Output — DomainForge
-
-```
-DomainForge Analysis — Developer Config Management
-
-Archetype: DevTool / Infrastructure
-Mode: Indie Hacker
+## Packs vs individual skills
 
-Top Recommendations
+A pack is a folder of related skills that work together. Install a pack and you get all the skills inside it.
 
-1. krev.dev — 93/100
-   Hard consonant, 4 chars, terminal-native in lowercase.
-   Zero overlap with Vault/dotenv cluster. Premium DevTool energy.
-   Domain: krev.dev — available (~$12/yr Porkbun)
-   Social: @krev — available on X, GitHub
-   Trademark: Clean
+```bash
+# Install the full naming-suite pack (4 skills)
+npx @veyralabs/skills install naming-suite
 
-2. onyx.sh — 89/100
-   Single hard word, immediate memorability, shell-adjacent TLD.
-   Domain: onyx.sh — available (~$18/yr)
-   Social: @onyxdev — available
-   Trademark: Check in software category
+# Install just one skill from the pack
+npx @veyralabs/skills install domainforge
 ```
 
 ---
 
-## Supported Agents
-
-| Agent | Supported |
-|-------|-----------|
-| Claude Code | ✅ |
-| Cursor | ✅ |
-| Windsurf | ✅ |
-| Gemini CLI | ✅ |
-| GitHub Copilot | ✅ |
-| Codex | ✅ |
-| Cline | ✅ |
-| Goose | ✅ |
-| OpenHands | ✅ |
-| Roo Code | ✅ |
-
----
-
-## Roadmap
+## Coming soon
 
-**naming-suite** — stable, all 4 skills available now
-
-**brand-suite** *(coming soon)*
+**brand-suite**
 - `brandvoice` — tone of voice guide generator
-- `brandpositioning` — positioning statement + competitive differentiation
+- `brandpositioning` — positioning statement and competitive differentiation
 - `taglineforge` — tagline generation with scoring
 
-**gtm-suite** *(coming soon)*
+**gtm-suite**
 - `icp` — Ideal Customer Profile builder
 - `pricingstrategy` — pricing model analysis
 - `gtmplan` — go-to-market plan generator
 
 ---
 
-## Contributing
+## Individual packages
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on submitting new skills.
+Each skill is also published as a standalone npm package if you only want one:
 
-Validate before opening a PR:
+- `@veyralabs/naming-suite`
+- `@veyralabs/webcloner`
+
+---
+
+## Contributing
+
+Validate your skill before opening a PR:
 
 ```bash
 node validate.js
 ```
 
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide.
+
 ---
 
 ## License
 
-MIT — use, fork, modify, distribute freely.
-
-Built by [VeyraLabs](https://veyralabs.com).
+MIT. Built by [VeyraLabs](https://veyralabs.com).

package/bin/cli.js

@@ -5,24 +5,53 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const SKILLS_DIR = path.join(__dirname, '..', 'skills');
-
-const PACKS = {
-  'naming-suite': ['domainforge', 'brandaudit', 'competitornames', 'namingguide'],
-};
+const SKILLS_DIR   = path.join(__dirname, '..', 'skills');
+const COMMANDS_DIR = path.join(__dirname, '..', 'commands');
 
 const AGENT_PATHS = {
-  claude:    { local: '.claude/skills',                  global: '.claude/skills' },
-  cursor:    { local: '.cursor/skills',                  global: '.cursor/skills' },
-  windsurf:  { local: '.windsurf/skills',                global: '.codeium/windsurf/skills' },
-  gemini:    { local: '.gemini/skills',                  global: '.gemini/skills' },
-  copilot:   { local: '.github/skills',                  global: '.copilot/skills' },
-  cline:     { local: '.cline/skills',                   global: '.cline/skills' },
-  goose:     { local: '.goose/skills',                   global: '.config/goose/skills' },
-  openhands: { local: '.openhands/skills',               global: '.openhands/skills' },
-  roo:       { local: '.roo/skills',                     global: '.roo/skills' },
+  claude:    { local: '.claude/skills',             global: '.claude/skills' },
+  cursor:    { local: '.cursor/skills',             global: '.cursor/skills' },
+  windsurf:  { local: '.windsurf/skills',           global: '.codeium/windsurf/skills' },
+  gemini:    { local: '.gemini/skills',             global: '.gemini/skills' },
+  copilot:   { local: '.github/skills',             global: '.copilot/skills' },
+  cline:     { local: '.cline/skills',              global: '.cline/skills' },
+  goose:     { local: '.goose/skills',              global: '.config/goose/skills' },
+  openhands: { local: '.openhands/skills',          global: '.openhands/skills' },
+  roo:       { local: '.roo/skills',                global: '.roo/skills' },
 };
 
+// Auto-discover skills and packs from filesystem.
+// Standalone skill: skills/<name>/SKILL.md
+// Pack: skills/<pack>/<name>/SKILL.md (no SKILL.md at pack level)
+function discover() {
+  const skills = {};  // name → absolute path
+  const packs = {};   // packName → [skillName, ...]
+
+  if (!fs.existsSync(SKILLS_DIR)) return { skills, packs };
+
+  for (const entry of fs.readdirSync(SKILLS_DIR, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const entryPath = path.join(SKILLS_DIR, entry.name);
+
+    if (fs.existsSync(path.join(entryPath, 'SKILL.md'))) {
+      skills[entry.name] = entryPath;
+    } else {
+      const packSkills = [];
+      for (const sub of fs.readdirSync(entryPath, { withFileTypes: true })) {
+        if (!sub.isDirectory()) continue;
+        const subPath = path.join(entryPath, sub.name);
+        if (fs.existsSync(path.join(subPath, 'SKILL.md'))) {
+          skills[sub.name] = subPath;
+          packSkills.push(sub.name);
+        }
+      }
+      if (packSkills.length > 0) packs[entry.name] = packSkills;
+    }
+  }
+
+  return { skills, packs };
+}
+
 function detectAgent() {
   const cwd = process.cwd();
   for (const agent of Object.keys(AGENT_PATHS)) {
@@ -39,28 +68,31 @@ function resolveDestination(agent, isGlobal) {
     process.exit(1);
   }
   const rel = isGlobal ? entry.global : entry.local;
-  return isGlobal
-    ? path.join(os.homedir(), rel)
-    : path.join(process.cwd(), rel);
+  return isGlobal ? path.join(os.homedir(), rel) : path.join(process.cwd(), rel);
 }
 
-function copySkill(name, dest) {
-  const src = path.join(SKILLS_DIR, name);
-  if (!fs.existsSync(src)) {
-    console.error(`Skill not found: ${name}`);
-    console.error(`Available: ${availableSkills().join(', ')}`);
-    process.exit(1);
-  }
+function copySkill(name, skillPath, dest) {
   const target = path.join(dest, name);
   fs.mkdirSync(dest, { recursive: true });
-  fs.cpSync(src, target, { recursive: true });
+  fs.cpSync(skillPath, target, { recursive: true });
   console.log(`  ✓ ${name}`);
 }
 
-function availableSkills() {
-  return fs.readdirSync(SKILLS_DIR).filter(
-    f => fs.statSync(path.join(SKILLS_DIR, f)).isDirectory()
-  );
+// Copy slash commands — Claude Code only (.claude/commands/)
+function copyCommands(agent, isGlobal) {
+  if (agent !== 'claude') return;
+  if (!fs.existsSync(COMMANDS_DIR)) return;
+
+  const cmdDest = isGlobal
+    ? path.join(os.homedir(), '.claude', 'commands')
+    : path.join(process.cwd(), '.claude', 'commands');
+
+  fs.mkdirSync(cmdDest, { recursive: true });
+  for (const f of fs.readdirSync(COMMANDS_DIR)) {
+    if (!f.endsWith('.md')) continue;
+    fs.copyFileSync(path.join(COMMANDS_DIR, f), path.join(cmdDest, f));
+  }
+  console.log(`  ✓ slash commands → ${cmdDest}`);
 }
 
 function printHelp() {
@@ -77,7 +109,7 @@ Options:
 
 Examples:
   npx @veyralabs/skills install naming-suite
-  npx @veyralabs/skills install domainforge --global
+  npx @veyralabs/skills install webcloner --global
   npx @veyralabs/skills install domainforge --agent cursor
 `);
 }
@@ -98,13 +130,19 @@ if (!command || command === 'help' || command === '--help' || command === '-h')
   process.exit(0);
 }
 
+const { skills, packs } = discover();
+
 if (command === 'list') {
+  if (Object.keys(packs).length > 0) {
+    console.log('\nPacks:');
+    for (const [pack, members] of Object.entries(packs)) {
+      console.log(`  ${pack}  →  ${members.join(', ')}`);
+    }
+  }
   console.log('\nSkills:');
-  availableSkills().forEach(s => console.log(`  ${s}`));
-  console.log('\nPacks:');
-  Object.entries(PACKS).forEach(([pack, skills]) =>
-    console.log(`  ${pack}  →  ${skills.join(', ')}`)
-  );
+  for (const name of Object.keys(skills).sort()) {
+    console.log(`  ${name}`);
+  }
   console.log();
   process.exit(0);
 }
@@ -116,16 +154,22 @@ if (command === 'install') {
   let toInstall = [];
 
   if (!target) {
-    toInstall = availableSkills();
-  } else if (PACKS[target]) {
-    toInstall = PACKS[target];
-  } else {
+    toInstall = Object.keys(skills);
+  } else if (packs[target]) {
+    toInstall = packs[target];
+  } else if (skills[target]) {
     toInstall = [target];
+  } else {
+    console.error(`Not found: "${target}"`);
+    console.error(`Available skills: ${Object.keys(skills).join(', ')}`);
+    console.error(`Available packs:  ${Object.keys(packs).join(', ')}`);
+    process.exit(1);
   }
 
   const scope = isGlobal ? 'global' : 'project';
   console.log(`\nInstalling into ${dest} [${agent}/${scope}]\n`);
-  toInstall.forEach(s => copySkill(s, dest));
+  toInstall.forEach(name => copySkill(name, skills[name], dest));
+  copyCommands(agent, isGlobal);
   console.log('\nDone. Restart your agent to activate skills.\n');
   process.exit(0);
 }

package/commands/brandaudit.md

@@ -0,0 +1,3 @@
+Audit this brand name: $ARGUMENTS
+
+Use the brandaudit skill. Analyze across 8 dimensions, assign severity scores to each issue, and return a verdict: keep, refine, or rebrand. Include what is working, what is not, and the recommended path forward.

package/commands/competitornames.md

@@ -0,0 +1,3 @@
+Map the naming landscape for: $ARGUMENTS
+
+Use the competitornames skill. Identify naming clusters, saturation levels, and open whitespace in this market. Output a competitive naming brief ready to feed into domainforge.

package/commands/domainforge.md

@@ -0,0 +1,3 @@
+Generate startup name candidates for: $ARGUMENTS
+
+Use the domainforge skill. Score each candidate on 8 factors: memorability, distinctiveness, domain availability, trademark risk, pronunciation, spelling, brandability, market fit. Check domain availability and social handles. Return a ranked list with scores and a one-line brand narrative per name.

package/commands/namingguide.md

@@ -0,0 +1,3 @@
+Build a naming guide for: $ARGUMENTS
+
+Use the namingguide skill. Define naming principles, approved patterns, anti-patterns, real examples, and an approval checklist. Output a complete naming system the team can follow.

package/commands/webcloner.md

@@ -0,0 +1,5 @@
+Clone this website: $ARGUMENTS
+
+Use the webcloner skill. Start with the recon phase: run extract.py against the URL to get the full site manifest (DOM structure, computed CSS, assets, animation libraries, tech stack). Do not write any component code until the recon summary is reviewed.
+
+If the target is out of scope (SaaS dashboard, auth flow, real-time data), say so before starting.

package/install.sh

@@ -140,6 +140,28 @@ install_skill() {
   rm -rf "$tmp"
 }
 
+install_commands() {
+  local agent="$1"
+  local is_global="$2"
+  local tmp="$3"
+
+  # Slash commands are only supported by Claude Code
+  [[ "$agent" != "claude" ]] && return
+
+  local cmd_dir
+  if [[ "$is_global" == "true" ]]; then
+    cmd_dir="$HOME/.claude/commands"
+  else
+    cmd_dir=".claude/commands"
+  fi
+
+  if [[ -d "$tmp/commands" ]]; then
+    mkdir -p "$cmd_dir"
+    cp "$tmp/commands/"*.md "$cmd_dir/" 2>/dev/null || true
+    echo "  Slash commands → ${cmd_dir}/"
+  fi
+}
+
 install_all() {
   local dest_dir="$1"
   local tmp
@@ -150,7 +172,7 @@ install_all() {
 
   echo "  Cloning veyralabsgroup/veyraskills..."
   git clone --depth=1 --filter=blob:none --sparse "$GITHUB" "$tmp" -q
-  (cd "$tmp" && git sparse-checkout set "skills")
+  (cd "$tmp" && git sparse-checkout set "skills" "commands")
 
   if [[ ! -d "$tmp/skills" ]]; then
     echo "  Error: could not retrieve skills from repository."
@@ -159,6 +181,7 @@ install_all() {
 
   mkdir -p "$dest_dir"
   cp -r "$tmp/skills/." "$dest_dir/"
+  install_commands "$AGENT" "$GLOBAL" "$tmp"
 
   trap - EXIT
   rm -rf "$tmp"

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@veyralabs/skills",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "VeyraSkills — A curated collection of Claude Code skills for founders, developers and AI builders",
   "bin": {
-    "veyraskills": "./bin/cli.js"
+    "veyraskills": "bin/cli.js"
   },
   "files": [
     "bin/",
     "skills/",
+    "commands/",
     "install.sh",
     "validate.js"
   ],
@@ -35,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/veyralabsgroup/veyraskills.git"
+    "url": "git+https://github.com/veyralabsgroup/veyraskills.git"
   },
   "bugs": {
     "url": "https://github.com/veyralabsgroup/veyraskills/issues"