@rbbtsn0w/adg 0.1.0-alpha.1

package/vendor/skills/src/cli.ts

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
+import { basename, join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { runAdd, parseAddOptions, initTelemetry } from './add.ts';
+import { runFind } from './find.ts';
+import { runInstallFromLock } from './install.ts';
+import { runList } from './list.ts';
+import { removeCommand, parseRemoveOptions } from './remove.ts';
+import { runSync, parseSyncOptions } from './sync.ts';
+import { flushTelemetry } from './telemetry.ts';
+import { isRunningInAgent } from './detect-agent.ts';
+import { runUpdate } from './update.ts';
+import { runUse, parseUseOptions } from './use.ts';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function getVersion(): string {
+  try {
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+  } catch {
+    return '0.0.0';
+  }
+}
+
+const VERSION = getVersion();
+initTelemetry(VERSION);
+
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+// 256-color grays - visible on both light and dark backgrounds
+const DIM = '\x1b[38;5;102m'; // darker gray for secondary text
+const TEXT = '\x1b[38;5;145m'; // lighter gray for primary text
+
+const LOGO_LINES = [
+  '███████╗██╗  ██╗██╗██╗     ██╗     ███████╗',
+  '██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝',
+  '███████╗█████╔╝ ██║██║     ██║     ███████╗',
+  '╚════██║██╔═██╗ ██║██║     ██║     ╚════██║',
+  '███████║██║  ██╗██║███████╗███████╗███████║',
+  '╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝',
+];
+
+// 256-color middle grays - visible on both light and dark backgrounds
+const GRAYS = [
+  '\x1b[38;5;250m', // lighter gray
+  '\x1b[38;5;248m',
+  '\x1b[38;5;245m', // mid gray
+  '\x1b[38;5;243m',
+  '\x1b[38;5;240m',
+  '\x1b[38;5;238m', // darker gray
+];
+
+function showLogo(): void {
+  console.log();
+  LOGO_LINES.forEach((line, i) => {
+    console.log(`${GRAYS[i]}${line}${RESET}`);
+  });
+}
+
+function showBanner(): void {
+  showLogo();
+  console.log();
+  console.log(`${DIM}The open agent skills ecosystem${RESET}`);
+  console.log();
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills add ${DIM}<package>${RESET}        ${DIM}Add a new skill${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills use ${DIM}<package>@<skill>${RESET} ${DIM}Use a skill without installing${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills remove${RESET}               ${DIM}Remove installed skills${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills list${RESET}                 ${DIM}List installed skills${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills find ${DIM}[query]${RESET}         ${DIM}Search for skills${RESET}`
+  );
+  console.log();
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills update${RESET}               ${DIM}Update installed skills${RESET}`
+  );
+  console.log();
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`
+  );
+  console.log(
+    `  ${DIM}$${RESET} ${TEXT}npx skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`
+  );
+  console.log();
+  console.log(`${DIM}try:${RESET} npx skills add vercel-labs/agent-skills`);
+  console.log();
+  console.log(`Discover more skills at ${TEXT}https://skills.sh/${RESET}`);
+  console.log();
+}
+
+function showHelp(): void {
+  console.log(`
+${BOLD}Usage:${RESET} skills <command> [options]
+
+${BOLD}Manage Skills:${RESET}
+  add <package>        Add a skill package (alias: a)
+                       e.g. vercel-labs/agent-skills
+                            https://github.com/vercel-labs/agent-skills
+  use <package>@<skill>
+                       Generate a prompt for using one skill without installing it
+  remove [skills]      Remove installed skills
+  list, ls             List installed skills
+  find [query]         Search for skills interactively
+
+${BOLD}Updates:${RESET}
+  update [skills...]   Update skills to latest versions (alias: upgrade)
+
+${BOLD}Update Options:${RESET}
+  -g, --global           Update global skills only
+  -p, --project          Update project skills only
+  -y, --yes              Skip scope prompt (auto-detect: project if in a project, else global)
+
+${BOLD}Project:${RESET}
+  experimental_install Restore skills from skills-lock.json
+  init [name]          Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)
+  experimental_sync    Sync skills from node_modules into agent directories
+
+${BOLD}Add Options:${RESET}
+  -g, --global           Install skill globally (user-level) instead of project-level
+  -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
+  -s, --skill <skills>   Specify skill names to install (use '*' for all skills)
+  -l, --list             List available skills in the repository without installing
+  -y, --yes              Skip confirmation prompts
+  --copy                 Copy files instead of symlinking to agent directories
+  --all                  Shorthand for --skill '*' --agent '*' -y
+  --full-depth           Search all subdirectories even when a root SKILL.md exists
+
+${BOLD}Use Options:${RESET}
+  -s, --skill <skill>    Specify the skill to use
+  -a, --agent <agent>    Start one supported agent interactively
+  --full-depth           Search all subdirectories even when a root SKILL.md exists
+  --dangerously-accept-openclaw-risks
+                         Allow unverified OpenClaw community skills
+
+${BOLD}Remove Options:${RESET}
+  -g, --global           Remove from global scope
+  -a, --agent <agents>   Remove from specific agents (use '*' for all agents)
+  -s, --skill <skills>   Specify skills to remove (use '*' for all skills)
+  -y, --yes              Skip confirmation prompts
+  --all                  Shorthand for --skill '*' --agent '*' -y
+  
+${BOLD}Experimental Sync Options:${RESET}
+  -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
+  -y, --yes              Skip confirmation prompts
+
+${BOLD}List Options:${RESET}
+  -g, --global           List global skills (default: project)
+  -a, --agent <agents>   Filter by specific agents
+  --json                 Output as JSON (machine-readable, no ANSI codes)
+
+${BOLD}Options:${RESET}
+  --help, -h        Show this help message
+  --version, -v     Show version number
+
+${BOLD}Examples:${RESET}
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills
+  ${DIM}$${RESET} skills use vercel-labs/agent-skills@vercel-optimize | claude
+  ${DIM}$${RESET} skills use vercel-labs/agent-skills --skill vercel-optimize --agent claude-code
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills -g
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills --agent claude-code cursor
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills --skill pr-review commit
+  ${DIM}$${RESET} skills remove                        ${DIM}# interactive remove${RESET}
+  ${DIM}$${RESET} skills remove web-design             ${DIM}# remove by name${RESET}
+  ${DIM}$${RESET} skills rm --global frontend-design
+  ${DIM}$${RESET} skills list                          ${DIM}# list project skills${RESET}
+  ${DIM}$${RESET} skills ls -g                         ${DIM}# list global skills${RESET}
+  ${DIM}$${RESET} skills ls -a claude-code             ${DIM}# filter by agent${RESET}
+  ${DIM}$${RESET} skills ls --json                      ${DIM}# JSON output${RESET}
+  ${DIM}$${RESET} skills find                          ${DIM}# interactive search${RESET}
+  ${DIM}$${RESET} skills find typescript               ${DIM}# search by keyword${RESET}
+  ${DIM}$${RESET} skills update
+  ${DIM}$${RESET} skills update my-skill             ${DIM}# update a single skill${RESET}
+  ${DIM}$${RESET} skills update -g                    ${DIM}# update global skills only${RESET}
+  ${DIM}$${RESET} skills experimental_install            ${DIM}# restore from skills-lock.json${RESET}
+  ${DIM}$${RESET} skills init my-skill
+  ${DIM}$${RESET} skills experimental_sync              ${DIM}# sync from node_modules${RESET}
+  ${DIM}$${RESET} skills experimental_sync -y           ${DIM}# sync without prompts${RESET}
+
+Discover more skills at ${TEXT}https://skills.sh/${RESET}
+`);
+}
+
+function showRemoveHelp(): void {
+  console.log(`
+${BOLD}Usage:${RESET} skills remove [skills...] [options]
+
+${BOLD}Description:${RESET}
+  Remove installed skills from agents. If no skill names are provided,
+  an interactive selection menu will be shown.
+
+${BOLD}Arguments:${RESET}
+  skills            Optional skill names to remove (space-separated)
+
+${BOLD}Options:${RESET}
+  -g, --global       Remove from global scope (~/) instead of project scope
+  -a, --agent        Remove from specific agents (use '*' for all agents)
+  -s, --skill        Specify skills to remove (use '*' for all skills)
+  -y, --yes          Skip confirmation prompts
+  --all              Shorthand for --skill '*' --agent '*' -y
+
+${BOLD}Examples:${RESET}
+  ${DIM}$${RESET} skills remove                           ${DIM}# interactive selection${RESET}
+  ${DIM}$${RESET} skills remove my-skill                   ${DIM}# remove specific skill${RESET}
+  ${DIM}$${RESET} skills remove skill1 skill2 -y           ${DIM}# remove multiple skills${RESET}
+  ${DIM}$${RESET} skills remove --global my-skill          ${DIM}# remove from global scope${RESET}
+  ${DIM}$${RESET} skills rm --agent claude-code my-skill   ${DIM}# remove from specific agent${RESET}
+  ${DIM}$${RESET} skills remove --all                      ${DIM}# remove all skills${RESET}
+  ${DIM}$${RESET} skills remove --skill '*' -a cursor      ${DIM}# remove all skills from cursor${RESET}
+
+Discover more skills at ${TEXT}https://skills.sh/${RESET}
+`);
+}
+
+function runInit(args: string[]): void {
+  const cwd = process.cwd();
+  const skillName = args[0] || basename(cwd);
+  const hasName = args[0] !== undefined;
+
+  const skillDir = hasName ? join(cwd, skillName) : cwd;
+  const skillFile = join(skillDir, 'SKILL.md');
+  const displayPath = hasName ? `${skillName}/SKILL.md` : 'SKILL.md';
+
+  if (existsSync(skillFile)) {
+    console.log(`${TEXT}Skill already exists at ${DIM}${displayPath}${RESET}`);
+    return;
+  }
+
+  if (hasName) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+
+  const skillContent = `---
+name: ${skillName}
+description: A brief description of what this skill does
+---
+
+# ${skillName}
+
+Instructions for the agent to follow when this skill is activated.
+
+## When to use
+
+Describe when this skill should be used.
+
+## Instructions
+
+1. First step
+2. Second step
+3. Additional steps as needed
+`;
+
+  writeFileSync(skillFile, skillContent);
+
+  console.log(`${TEXT}Initialized skill: ${DIM}${skillName}${RESET}`);
+  console.log();
+  console.log(`${DIM}Created:${RESET}`);
+  console.log(`  ${displayPath}`);
+  console.log();
+  console.log(`${DIM}Next steps:${RESET}`);
+  console.log(`  1. Edit ${TEXT}${displayPath}${RESET} to define your skill instructions`);
+  console.log(
+    `  2. Update the ${TEXT}name${RESET} and ${TEXT}description${RESET} in the frontmatter`
+  );
+  console.log();
+  console.log(`${DIM}Publishing:${RESET}`);
+  console.log(
+    `  ${DIM}GitHub:${RESET}  Push to a repo, then ${TEXT}npx skills add <owner>/<repo>${RESET}`
+  );
+  console.log(
+    `  ${DIM}URL:${RESET}     Host the file, then ${TEXT}npx skills add https://example.com/${displayPath}${RESET}`
+  );
+  console.log();
+  console.log(`Browse existing skills for inspiration at ${TEXT}https://skills.sh/${RESET}`);
+  console.log();
+}
+
+// ============================================
+// Main
+// ============================================
+
+async function main(): Promise<void> {
+  const args = process.argv.slice(2);
+  const inAgent = await isRunningInAgent();
+
+  if (args.length === 0) {
+    if (!inAgent) {
+      showBanner();
+    }
+    return;
+  }
+
+  const command = args[0];
+  const restArgs = args.slice(1);
+
+  switch (command) {
+    case 'find':
+    case 'search':
+    case 'f':
+    case 's':
+      if (!inAgent) showLogo();
+      console.log();
+      await runFind(restArgs);
+      break;
+    case 'init':
+      if (!inAgent) showLogo();
+      console.log();
+      runInit(restArgs);
+      break;
+    case 'experimental_install': {
+      if (!inAgent) showLogo();
+      await runInstallFromLock(restArgs);
+      break;
+    }
+    case 'i':
+    case 'install':
+    case 'a':
+    case 'add': {
+      if (!inAgent) showLogo();
+      const { source: addSource, options: addOpts } = parseAddOptions(restArgs);
+      await runAdd(addSource, addOpts);
+      break;
+    }
+    case 'use': {
+      const {
+        source: useSource,
+        options: useOptions,
+        errors: useErrors,
+      } = parseUseOptions(restArgs);
+      await runUse(useSource, useOptions, useErrors);
+      break;
+    }
+    case 'remove':
+    case 'rm':
+    case 'r':
+      // Check for --help or -h flag
+      if (restArgs.includes('--help') || restArgs.includes('-h')) {
+        showRemoveHelp();
+        break;
+      }
+      const { skills, options: removeOptions } = parseRemoveOptions(restArgs);
+      await removeCommand(skills, removeOptions);
+      break;
+    case 'experimental_sync': {
+      if (!inAgent) showLogo();
+      const { options: syncOptions } = parseSyncOptions(restArgs);
+      await runSync(restArgs, syncOptions);
+      break;
+    }
+    case 'list':
+    case 'ls':
+      await runList(restArgs);
+      break;
+    case 'check':
+    case 'update':
+    case 'upgrade':
+      await runUpdate(restArgs);
+      break;
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+    case '--version':
+    case '-v':
+      console.log(VERSION);
+      break;
+
+    default:
+      console.log(`Unknown command: ${command}`);
+      console.log(`Run ${BOLD}skills --help${RESET} for usage.`);
+  }
+}
+
+main().finally(() => flushTelemetry().then(() => process.exit(0)));

package/vendor/skills/src/constants.ts

@@ -0,0 +1,3 @@
+export const AGENTS_DIR = '.agents';
+export const SKILLS_SUBDIR = 'skills';
+export const UNIVERSAL_SKILLS_DIR = '.agents/skills';

package/vendor/skills/src/detect-agent.ts

@@ -0,0 +1,62 @@
+import { determineAgent, type AgentResult } from '@vercel/detect-agent';
+import { setDetectedAgent } from './telemetry.ts';
+import type { AgentType } from './types.ts';
+
+let cachedResult: AgentResult | null = null;
+
+/**
+ * Map from @vercel/detect-agent names to skills-cli AgentType identifiers.
+ * Only includes agents that exist in both systems.
+ */
+const agentNameToType: Record<string, AgentType> = {
+  cursor: 'cursor',
+  'cursor-cli': 'cursor',
+  claude: 'claude-code',
+  cowork: 'claude-code',
+  devin: 'universal', // Devin not in skills-cli agent list, use universal
+  replit: 'replit',
+  gemini: 'gemini-cli',
+  codex: 'codex',
+  antigravity: 'antigravity',
+  'augment-cli': 'augment',
+  opencode: 'opencode',
+  'github-copilot': 'github-copilot',
+};
+
+/**
+ * Detect if the CLI is being run inside an AI agent environment.
+ * Results are cached after the first call. Also updates telemetry with the agent name.
+ */
+export async function detectAgent(): Promise<AgentResult> {
+  if (cachedResult) return cachedResult;
+  cachedResult = await determineAgent();
+  if (cachedResult.isAgent) {
+    setDetectedAgent(cachedResult.agent.name);
+  }
+  return cachedResult;
+}
+
+/**
+ * Returns true if the CLI is running inside a detected AI agent.
+ * When true, the CLI should skip interactive prompts and use sensible defaults.
+ */
+export async function isRunningInAgent(): Promise<boolean> {
+  const result = await detectAgent();
+  return result.isAgent;
+}
+
+/**
+ * Returns the name of the detected agent, or null if not running in an agent.
+ */
+export async function getAgentName(): Promise<string | null> {
+  const result = await detectAgent();
+  return result.isAgent ? result.agent.name : null;
+}
+
+/**
+ * Maps a detected agent name to the corresponding skills-cli AgentType.
+ * Returns null if the agent can't be mapped to a specific skills-cli agent.
+ */
+export function getAgentType(agentName: string): AgentType | null {
+  return agentNameToType[agentName] ?? null;
+}