@veyralabs/skills 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VeyraLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+# VeyraLabs Skills
+
+[![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)
+
+A curated collection of agent skills for founders, developers, and builders. Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, and 30+ more.
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh)
+```
+
+---
+
+## Packs
+
+### `naming-suite` — Brand & Naming Intelligence
+
+Four skills that work together. Find names, audit brands, map competitors, generate naming guides.
+
+| 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 |
+
+**Recommended flow:**
+
+```
+competitornames → domainforge
+brandaudit      → namingguide
+```
+
+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.
+
+---
+
+## Installation
+
+### One-line
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh)
+```
+
+Installs all available skills into your current project.
+
+### Specific skill
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh) --skill domainforge
+```
+
+### Global install (available across all projects)
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/veyralabsgroup/veyraskills/main/install.sh) --global
+```
+
+### Manual
+
+Copy the skill folder to your agent's skills directory and restart the agent.
+
+| Agent | Project | Global |
+|-------|---------|--------|
+| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
+| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
+| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |
+| GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
+
+---
+
+## Usage
+
+Once installed, skills activate contextually — no configuration needed.
+
+**DomainForge:**
+```
+Find a domain for my new SaaS
+Name my CLI tool for environment variables
+What should I call this project?
+```
+
+**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
+```
+
+---
+
+## Example Output — DomainForge
+
+```
+DomainForge Analysis — Developer Config Management
+
+Archetype: DevTool / Infrastructure
+Mode: Indie Hacker
+
+Top Recommendations
+
+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
+
+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
+```
+
+---
+
+## Supported Agents
+
+| Agent | Supported |
+|-------|-----------|
+| Claude Code | ✅ |
+| Cursor | ✅ |
+| Windsurf | ✅ |
+| Gemini CLI | ✅ |
+| GitHub Copilot | ✅ |
+| Codex | ✅ |
+| Cline | ✅ |
+| Goose | ✅ |
+| OpenHands | ✅ |
+| Roo Code | ✅ |
+
+---
+
+## Roadmap
+
+**naming-suite** — stable, all 4 skills available now
+
+**brand-suite** *(coming soon)*
+- `brandvoice` — tone of voice guide generator
+- `brandpositioning` — positioning statement + competitive differentiation
+- `taglineforge` — tagline generation with scoring
+
+**gtm-suite** *(coming soon)*
+- `icp` — Ideal Customer Profile builder
+- `pricingstrategy` — pricing model analysis
+- `gtmplan` — go-to-market plan generator
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on submitting new skills.
+
+Validate before opening a PR:
+
+```bash
+node validate.js
+```
+
+---
+
+## License
+
+MIT — use, fork, modify, distribute freely.
+
+Built by [VeyraLabs](https://veyralabs.com).

package/bin/cli.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+'use strict';
+
+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 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' },
+};
+
+function detectAgent() {
+  const cwd = process.cwd();
+  for (const agent of Object.keys(AGENT_PATHS)) {
+    const dir = agent === 'copilot' ? '.github' : `.${agent}`;
+    if (fs.existsSync(path.join(cwd, dir))) return agent;
+  }
+  return 'claude';
+}
+
+function resolveDestination(agent, isGlobal) {
+  const entry = AGENT_PATHS[agent];
+  if (!entry) {
+    console.error(`Unknown agent: ${agent}. Options: ${Object.keys(AGENT_PATHS).join(', ')}`);
+    process.exit(1);
+  }
+  const rel = isGlobal ? entry.global : entry.local;
+  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);
+  }
+  const target = path.join(dest, name);
+  fs.mkdirSync(dest, { recursive: true });
+  fs.cpSync(src, target, { recursive: true });
+  console.log(`  ✓ ${name}`);
+}
+
+function availableSkills() {
+  return fs.readdirSync(SKILLS_DIR).filter(
+    f => fs.statSync(path.join(SKILLS_DIR, f)).isDirectory()
+  );
+}
+
+function printHelp() {
+  console.log(`
+Usage:
+  npx @veyralabs/skills install                     Install all skills
+  npx @veyralabs/skills install <skill|pack>        Install a skill or pack
+  npx @veyralabs/skills list                        List available skills and packs
+
+Options:
+  --global              Install globally (all projects)
+  --agent <name>        Target agent (auto-detected if omitted)
+                        Options: ${Object.keys(AGENT_PATHS).join(', ')}
+
+Examples:
+  npx @veyralabs/skills install naming-suite
+  npx @veyralabs/skills install domainforge --global
+  npx @veyralabs/skills install domainforge --agent cursor
+`);
+}
+
+// --- Parse args ---
+
+const rawArgs = process.argv.slice(2);
+const command = rawArgs[0];
+const target = rawArgs[1] && !rawArgs[1].startsWith('--') ? rawArgs[1] : undefined;
+const isGlobal = rawArgs.includes('--global');
+const agentIdx = rawArgs.indexOf('--agent');
+const agentArg = agentIdx !== -1 ? rawArgs[agentIdx + 1] : null;
+
+// --- Commands ---
+
+if (!command || command === 'help' || command === '--help' || command === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+if (command === 'list') {
+  console.log('\nSkills:');
+  availableSkills().forEach(s => console.log(`  ${s}`));
+  console.log('\nPacks:');
+  Object.entries(PACKS).forEach(([pack, skills]) =>
+    console.log(`  ${pack}  →  ${skills.join(', ')}`)
+  );
+  console.log();
+  process.exit(0);
+}
+
+if (command === 'install') {
+  const agent = agentArg || detectAgent();
+  const dest = resolveDestination(agent, isGlobal);
+
+  let toInstall = [];
+
+  if (!target) {
+    toInstall = availableSkills();
+  } else if (PACKS[target]) {
+    toInstall = PACKS[target];
+  } else {
+    toInstall = [target];
+  }
+
+  const scope = isGlobal ? 'global' : 'project';
+  console.log(`\nInstalling into ${dest} [${agent}/${scope}]\n`);
+  toInstall.forEach(s => copySkill(s, dest));
+  console.log('\nDone. Restart your agent to activate skills.\n');
+  process.exit(0);
+}
+
+console.error(`Unknown command: ${command}`);
+printHelp();
+process.exit(1);

package/install.sh

@@ -0,0 +1,226 @@
+#!/usr/bin/env bash
+# VeyraLabs Skills installer
+# https://github.com/veyralabsgroup/veyraskills
+
+set -euo pipefail
+
+REPO="veyralabsgroup/veyraskills"
+GITHUB="https://github.com/${REPO}.git"
+
+SKILL_NAME=""
+GLOBAL=false
+AGENT=""
+LIST_ONLY=false
+
+# ── argument parsing ─────────────────────────────────────────────────────────
+
+usage() {
+  cat <<EOF
+VeyraLabs Skills — installer
+
+Usage:
+  bash install.sh [options]
+
+Options:
+  --skill <name>    Install a specific skill (default: all)
+  --global          Install globally instead of project-local
+  --agent <name>    Target agent (auto-detected if omitted)
+  --list            List available skills
+  -h, --help        Show this help
+
+Supported agents:
+  claude, cursor, windsurf, gemini, copilot, cline, goose, openhands, roo
+
+Examples:
+  # Auto-detect agent, install all skills to current project
+  bash install.sh
+
+  # Install domainforge globally for Claude Code
+  bash install.sh --skill domainforge --global --agent claude
+
+  # List available skills
+  bash install.sh --list
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --skill)   SKILL_NAME="$2"; shift 2 ;;
+    --global)  GLOBAL=true; shift ;;
+    --agent)   AGENT="$2"; shift 2 ;;
+    --list)    LIST_ONLY=true; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *)         echo "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+# ── agent detection ──────────────────────────────────────────────────────────
+
+detect_agent() {
+  [[ -f ".claude/settings.json" ]] || [[ -d ".claude" ]]   && echo "claude"   && return
+  [[ -d ".cursor" ]]                                        && echo "cursor"   && return
+  [[ -d ".windsurf" ]]                                      && echo "windsurf" && return
+  [[ -d ".gemini" ]]                                        && echo "gemini"   && return
+  [[ -d ".github/copilot" ]]                                && echo "copilot"  && return
+  [[ -d ".cline" ]]                                         && echo "cline"    && return
+  [[ -d ".goose" ]]                                         && echo "goose"    && return
+  [[ -d ".openhands" ]]                                     && echo "openhands"&& return
+  [[ -d ".roo" ]]                                           && echo "roo"      && return
+  echo ""
+}
+
+skills_dir() {
+  local agent="$1"
+
+  if [[ "$GLOBAL" == "true" ]]; then
+    case "$agent" in
+      claude)    echo "$HOME/.claude/skills"                   ;;
+      cursor)    echo "$HOME/.cursor/skills"                   ;;
+      windsurf)  echo "$HOME/.codeium/windsurf/skills"         ;;
+      gemini)    echo "$HOME/.gemini/skills"                   ;;
+      copilot)   echo "$HOME/.copilot/skills"                  ;;
+      cline)     echo "$HOME/.cline/skills"                    ;;
+      goose)     echo "$HOME/.config/goose/skills"             ;;
+      openhands) echo "$HOME/.openhands/skills"                ;;
+      roo)       echo "$HOME/.roo/skills"                      ;;
+      *)         echo "$HOME/.skills"                          ;;
+    esac
+  else
+    case "$agent" in
+      claude)    echo ".claude/skills"   ;;
+      cursor)    echo ".cursor/skills"   ;;
+      windsurf)  echo ".windsurf/skills" ;;
+      gemini)    echo ".gemini/skills"   ;;
+      copilot)   echo ".github/skills"   ;;
+      cline)     echo ".cline/skills"    ;;
+      goose)     echo ".goose/skills"    ;;
+      openhands) echo ".openhands/skills";;
+      roo)       echo ".roo/skills"      ;;
+      *)         echo ".skills"          ;;
+    esac
+  fi
+}
+
+# ── install logic ────────────────────────────────────────────────────────────
+
+check_deps() {
+  local missing=()
+  command -v git &>/dev/null || missing+=("git")
+
+  if [[ ${#missing[@]} -gt 0 ]]; then
+    echo "Error: required tools missing: ${missing[*]}"
+    echo "Install git and try again."
+    exit 1
+  fi
+}
+
+install_skill() {
+  local skill="$1"
+  local dest_dir="$2"
+  local tmp
+
+  tmp=$(mktemp -d)
+  # shellcheck disable=SC2064
+  trap "rm -rf '$tmp'" EXIT
+
+  echo "  Cloning veyralabsgroup/veyraskills..."
+  git clone --depth=1 --filter=blob:none --sparse "$GITHUB" "$tmp" -q
+
+  (cd "$tmp" && git sparse-checkout set "skills/${skill}")
+
+  if [[ ! -d "$tmp/skills/${skill}" ]]; then
+    echo "  Error: skill '${skill}' not found in the repository."
+    exit 1
+  fi
+
+  mkdir -p "$dest_dir"
+  cp -r "$tmp/skills/${skill}" "$dest_dir/"
+
+  trap - EXIT
+  rm -rf "$tmp"
+}
+
+install_all() {
+  local dest_dir="$1"
+  local tmp
+
+  tmp=$(mktemp -d)
+  # shellcheck disable=SC2064
+  trap "rm -rf '$tmp'" EXIT
+
+  echo "  Cloning veyralabsgroup/veyraskills..."
+  git clone --depth=1 --filter=blob:none --sparse "$GITHUB" "$tmp" -q
+  (cd "$tmp" && git sparse-checkout set "skills")
+
+  if [[ ! -d "$tmp/skills" ]]; then
+    echo "  Error: could not retrieve skills from repository."
+    exit 1
+  fi
+
+  mkdir -p "$dest_dir"
+  cp -r "$tmp/skills/." "$dest_dir/"
+
+  trap - EXIT
+  rm -rf "$tmp"
+}
+
+list_skills() {
+  local tmp
+  tmp=$(mktemp -d)
+  trap "rm -rf '$tmp'" EXIT
+
+  git clone --depth=1 --filter=blob:none --sparse "$GITHUB" "$tmp" -q
+  (cd "$tmp" && git sparse-checkout set "skills")
+
+  echo "Available skills:"
+  echo ""
+  for d in "$tmp/skills"/*/; do
+    local name
+    name=$(basename "$d")
+    echo "  • $name"
+  done
+  echo ""
+  echo "Install:  bash install.sh --skill <name>"
+  echo "All:      bash install.sh"
+
+  trap - EXIT
+  rm -rf "$tmp"
+}
+
+# ── main ─────────────────────────────────────────────────────────────────────
+
+main() {
+  check_deps
+
+  if [[ "$LIST_ONLY" == "true" ]]; then
+    list_skills
+    exit 0
+  fi
+
+  if [[ -z "$AGENT" ]]; then
+    AGENT=$(detect_agent)
+    if [[ -z "$AGENT" ]]; then
+      echo "Could not detect an agent in the current directory."
+      echo "Specify one with --agent <name> (claude, cursor, windsurf, gemini, copilot, cline, goose)"
+      exit 1
+    fi
+    echo "Detected agent: $AGENT"
+  fi
+
+  local dest
+  dest=$(skills_dir "$AGENT")
+
+  if [[ -n "$SKILL_NAME" ]]; then
+    echo "Installing '$SKILL_NAME' → $dest/"
+    install_skill "$SKILL_NAME" "$dest"
+    echo ""
+    echo "Done. ${dest}/${SKILL_NAME}/ is ready."
+  else
+    echo "Installing all skills → $dest/"
+    install_all "$dest"
+    echo ""
+    echo "Done. All skills installed to ${dest}/"
+  fi
+}
+
+main

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@veyralabs/skills",
+  "version": "0.1.0",
+  "description": "VeyraSkills — A curated collection of Claude Code skills for founders, developers and AI builders",
+  "bin": {
+    "veyraskills": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "install.sh",
+    "validate.js"
+  ],
+  "scripts": {
+    "validate": "node validate.js"
+  },
+  "keywords": [
+    "claude-code",
+    "claude-skill",
+    "agent-skill",
+    "skills-sh",
+    "ai-agents",
+    "anthropic",
+    "claude",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "naming",
+    "domain-generator",
+    "startup-branding",
+    "brand-strategy",
+    "developer-tools"
+  ],
+  "author": "VeyraLabs <hello@veyralabs.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/veyralabsgroup/veyraskills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/veyralabsgroup/veyraskills/issues"
+  },
+  "homepage": "https://github.com/veyralabsgroup/veyraskills#readme",
+  "engines": {
+    "node": ">=18"
+  }
+}