add-skill 1.0.2 → 1.0.4

package/README.md

@@ -2,7 +2,7 @@
 
 Install agent skills onto your coding agents from any git repository.
 
-Supports [OpenCode](https://opencode.ai), [Claude Code](https://claude.ai/code), and [Codex](https://developers.openai.com/codex).
+Supports [OpenCode](https://opencode.ai), [Claude Code](https://claude.ai/code), [Codex](https://developers.openai.com/codex), and [Cursor](https://cursor.com).
 
 ## Quick Start
 
@@ -47,7 +47,7 @@ npx add-skill git@github.com:vercel-labs/agent-skills.git
 | Option | Description |
 |--------|-------------|
 | `-g, --global` | Install to user directory instead of project |
-| `-a, --agent <agents...>` | Target specific agents: `opencode`, `claude-code`, `codex` |
+| `-a, --agent <agents...>` | Target specific agents: `opencode`, `claude-code`, `codex`, `cursor` |
 | `-s, --skill <skills...>` | Install specific skills by name |
 | `-l, --list` | List available skills without installing |
 | `-y, --yes` | Skip all confirmation prompts |
@@ -86,6 +86,7 @@ Installed in your current working directory. Commit these to share with your tea
 | OpenCode | `.opencode/skill/<name>/` |
 | Claude Code | `.claude/skills/<name>/` |
 | Codex | `.codex/skills/<name>/` |
+| Cursor | `.cursor/skills/<name>/` |
 
 ### Global (`--global`)
 
@@ -96,6 +97,7 @@ Installed in your home directory. Available across all projects.
 | OpenCode | `~/.config/opencode/skill/<name>/` |
 | Claude Code | `~/.claude/skills/<name>/` |
 | Codex | `~/.codex/skills/<name>/` |
+| Cursor | `~/.cursor/skills/<name>/` |
 
 ## Agent Detection
 
@@ -142,6 +144,7 @@ The CLI searches for skills in these locations within a repository:
 - `.codex/skills/`
 - `.claude/skills/`
 - `.opencode/skill/`
+- `.cursor/skills/`
 
 If no skills are found in standard locations, a recursive search is performed.
 
@@ -149,12 +152,12 @@ If no skills are found in standard locations, a recursive search is performed.
 
 Skills are generally compatible across agents since they follow a shared [Agent Skills specification](https://agentskills.io). However, some features may be agent-specific:
 
-| Feature | OpenCode | Claude Code | Codex |
-|---------|----------|-------------|-------|
-| Basic skills | Yes | Yes | Yes |
-| `allowed-tools` | Yes | Yes | Yes |
-| `context: fork` | No | Yes | No |
-| Hooks | No | Yes | No |
+| Feature | OpenCode | Claude Code | Codex | Cursor |
+|---------|----------|-------------|-------|--------|
+| Basic skills | Yes | Yes | Yes | Yes |
+| `allowed-tools` | Yes | Yes | Yes | Yes |
+| `context: fork` | No | Yes | No | No |
+| Hooks | No | Yes | No | No |
 
 ## Troubleshooting
 
@@ -179,6 +182,7 @@ Ensure you have write access to the target directory.
 - [OpenCode Skills Documentation](https://opencode.ai/docs/skills/)
 - [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)
 - [Codex Skills Documentation](https://developers.openai.com/codex/skills/)
+- [Cursor Skills Documentation](https://cursor.com/docs/context/skills)
 
 ## License
 

package/dist/index.js

@@ -143,7 +143,8 @@ async function discoverSkills(basePath, subpath) {
     join2(searchPath, "skills/.system"),
     join2(searchPath, ".codex/skills"),
     join2(searchPath, ".claude/skills"),
-    join2(searchPath, ".opencode/skill")
+    join2(searchPath, ".opencode/skill"),
+    join2(searchPath, ".cursor/skills")
   ];
   for (const dir of prioritySearchDirs) {
     try {
@@ -215,6 +216,15 @@ var agents = {
     detectInstalled: async () => {
       return existsSync(join3(home, ".codex"));
     }
+  },
+  cursor: {
+    name: "cursor",
+    displayName: "Cursor",
+    skillsDir: ".cursor/skills",
+    globalSkillsDir: join3(home, ".cursor/skills"),
+    detectInstalled: async () => {
+      return existsSync(join3(home, ".cursor"));
+    }
   }
 };
 async function detectInstalledAgents() {
@@ -277,7 +287,7 @@ function getInstallPath(skillName, agentType, options = {}) {
 
 // src/index.ts
 var version = "1.0.0";
-program.name("add-skill").description("Install skills onto coding agents (OpenCode, Claude Code, Codex)").version(version).argument("<source>", "Git repo URL, GitHub shorthand (owner/repo), or direct path to skill").option("-g, --global", "Install skill globally (user-level) instead of project-level").option("-a, --agent <agents...>", "Specify agents to install to (opencode, claude-code, codex)").option("-s, --skill <skills...>", "Specify skill names to install (skip selection prompt)").option("-l, --list", "List available skills in the repository without installing").option("-y, --yes", "Skip confirmation prompts").action(async (source, options) => {
+program.name("add-skill").description("Install skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)").version(version).argument("<source>", "Git repo URL, GitHub shorthand (owner/repo), or direct path to skill").option("-g, --global", "Install skill globally (user-level) instead of project-level").option("-a, --agent <agents...>", "Specify agents to install to (opencode, claude-code, codex, cursor)").option("-s, --skill <skills...>", "Specify skill names to install (skip selection prompt)").option("-l, --list", "List available skills in the repository without installing").option("-y, --yes", "Skip confirmation prompts").action(async (source, options) => {
   await main(source, options);
 });
 program.parse();
@@ -359,7 +369,7 @@ async function main(source, options) {
     }
     let targetAgents;
     if (options.agent && options.agent.length > 0) {
-      const validAgents = ["opencode", "claude-code", "codex"];
+      const validAgents = ["opencode", "claude-code", "codex", "cursor"];
       const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
       if (invalidAgents.length > 0) {
         p.log.error(`Invalid agents: ${invalidAgents.join(", ")}`);
@@ -374,7 +384,7 @@ async function main(source, options) {
       spinner2.stop(`Detected ${installedAgents.length} agent${installedAgents.length !== 1 ? "s" : ""}`);
       if (installedAgents.length === 0) {
         if (options.yes) {
-          targetAgents = ["opencode", "claude-code", "codex"];
+          targetAgents = ["opencode", "claude-code", "codex", "cursor"];
           p.log.info("Installing to all agents (none detected)");
         } else {
           p.log.warn("No coding agents detected. You can still install skills.");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "add-skill",
-  "version": "1.0.2",
-  "description": "Install agent skills onto coding agents (OpenCode, Claude Code, Codex)",
+  "version": "1.0.4",
+  "description": "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   "type": "module",
   "bin": {
     "add-skill": "./dist/index.js"
@@ -17,6 +17,7 @@
     "opencode",
     "claude-code",
     "codex",
+    "cursor",
     "ai-agents"
   ],
   "author": "",

package/src/agents.ts

@@ -33,6 +33,15 @@ export const agents: Record<AgentType, AgentConfig> = {
       return existsSync(join(home, '.codex'));
     },
   },
+  cursor: {
+    name: 'cursor',
+    displayName: 'Cursor',
+    skillsDir: '.cursor/skills',
+    globalSkillsDir: join(home, '.cursor/skills'),
+    detectInstalled: async () => {
+      return existsSync(join(home, '.cursor'));
+    },
+  },
 };
 
 export async function detectInstalledAgents(): Promise<AgentType[]> {

package/src/index.ts

@@ -21,11 +21,11 @@ interface Options {
 
 program
   .name('add-skill')
-  .description('Install skills onto coding agents (OpenCode, Claude Code, Codex)')
+  .description('Install skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)')
   .version(version)
   .argument('<source>', 'Git repo URL, GitHub shorthand (owner/repo), or direct path to skill')
   .option('-g, --global', 'Install skill globally (user-level) instead of project-level')
-  .option('-a, --agent <agents...>', 'Specify agents to install to (opencode, claude-code, codex)')
+  .option('-a, --agent <agents...>', 'Specify agents to install to (opencode, claude-code, codex, cursor)')
   .option('-s, --skill <skills...>', 'Specify skill names to install (skip selection prompt)')
   .option('-l, --list', 'List available skills in the repository without installing')
   .option('-y, --yes', 'Skip confirmation prompts')
@@ -131,7 +131,7 @@ async function main(source: string, options: Options) {
     let targetAgents: AgentType[];
 
     if (options.agent && options.agent.length > 0) {
-      const validAgents = ['opencode', 'claude-code', 'codex'];
+      const validAgents = ['opencode', 'claude-code', 'codex', 'cursor'];
       const invalidAgents = options.agent.filter(a => !validAgents.includes(a));
 
       if (invalidAgents.length > 0) {
@@ -149,7 +149,7 @@ async function main(source: string, options: Options) {
 
       if (installedAgents.length === 0) {
         if (options.yes) {
-          targetAgents = ['opencode', 'claude-code', 'codex'];
+          targetAgents = ['opencode', 'claude-code', 'codex', 'cursor'];
           p.log.info('Installing to all agents (none detected)');
         } else {
           p.log.warn('No coding agents detected. You can still install skills.');

package/src/skills.ts

@@ -84,6 +84,7 @@ export async function discoverSkills(basePath: string, subpath?: string): Promis
     join(searchPath, '.codex/skills'),
     join(searchPath, '.claude/skills'),
     join(searchPath, '.opencode/skill'),
+    join(searchPath, '.cursor/skills'),
   ];
 
   for (const dir of prioritySearchDirs) {

package/src/types.ts

@@ -1,4 +1,4 @@
-export type AgentType = 'opencode' | 'claude-code' | 'codex';
+export type AgentType = 'opencode' | 'claude-code' | 'codex' | 'cursor';
 
 export interface Skill {
   name: string;

package/.claude/skills/vercel-deploy/SKILL.md

@@ -1,109 +0,0 @@
----
-name: vercel-deploy
-description: Deploy applications and websites to Vercel. Use this skill when the user requests deployment actions such as "Deploy my app", "Deploy this to production", "Create a preview deployment", "Deploy and give me the link", or "Push this live". No authentication required - returns preview URL and claimable deployment link.
----
-
-# Vercel Deploy
-
-Deploy any project to Vercel instantly. No authentication required.
-
-## How It Works
-
-1. Packages your project into a tarball (excludes `node_modules` and `.git`)
-2. Auto-detects framework from `package.json`
-3. Uploads to deployment service
-4. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
-
-## Usage
-
-```bash
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
-```
-
-**Arguments:**
-- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
-
-**Examples:**
-
-```bash
-# Deploy current directory
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh
-
-# Deploy specific project
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project
-
-# Deploy existing tarball
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
-```
-
-## Output
-
-```
-Preparing deployment...
-Detected framework: nextjs
-Creating deployment package...
-Deploying...
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-```
-
-The script also outputs JSON to stdout for programmatic use:
-
-```json
-{
-  "previewUrl": "https://skill-deploy-abc123.vercel.app",
-  "claimUrl": "https://vercel.com/claim-deployment?code=...",
-  "deploymentId": "dpl_...",
-  "projectId": "prj_..."
-}
-```
-
-## Framework Detection
-
-The script auto-detects frameworks from `package.json`. Supported frameworks include:
-
-- **React**: Next.js, Gatsby, Create React App, Remix, React Router
-- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
-- **Svelte**: SvelteKit, Svelte, Sapper
-- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
-- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
-- **Build Tools**: Vite, Parcel
-- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
-
-For static HTML projects (no `package.json`), framework is set to `null`.
-
-## Static HTML Projects
-
-For projects without a `package.json`:
-- If there's a single `.html` file not named `index.html`, it gets renamed automatically
-- This ensures the page is served at the root URL (`/`)
-
-## Present Results to User
-
-Always show both URLs:
-
-```
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-
-View your site at the Preview URL.
-To transfer this deployment to your Vercel account, visit the Claim URL.
-```
-
-## Troubleshooting
-
-### Network Egress Error
-
-If deployment fails due to network restrictions (common on claude.ai), tell the user:
-
-```
-Deployment failed due to network restrictions. To fix this:
-
-1. Go to https://claude.ai/admin-settings/capabilities
-2. Add *.vercel.com to the allowed domains
-3. Try deploying again
-```

package/.claude/skills/vercel-deploy/scripts/deploy.sh

@@ -1,249 +0,0 @@
-#!/bin/bash
-
-# Vercel Deployment Script (via claimable deploy endpoint)
-# Usage: ./deploy.sh [project-path]
-# Returns: JSON with previewUrl, claimUrl, deploymentId, projectId
-
-set -e
-
-DEPLOY_ENDPOINT="https://claude-skills-deploy.vercel.com/api/deploy"
-
-# Detect framework from package.json
-detect_framework() {
-    local pkg_json="$1"
-
-    if [ ! -f "$pkg_json" ]; then
-        echo "null"
-        return
-    fi
-
-    local content=$(cat "$pkg_json")
-
-    # Helper to check if a package exists in dependencies or devDependencies
-    has_dep() {
-        echo "$content" | grep -q "\"$1\""
-    }
-
-    # Order matters - check more specific frameworks first
-
-    # Blitz
-    if has_dep "blitz"; then echo "blitzjs"; return; fi
-
-    # Next.js
-    if has_dep "next"; then echo "nextjs"; return; fi
-
-    # Gatsby
-    if has_dep "gatsby"; then echo "gatsby"; return; fi
-
-    # Remix
-    if has_dep "@remix-run/"; then echo "remix"; return; fi
-
-    # React Router (v7 framework mode)
-    if has_dep "@react-router/"; then echo "react-router"; return; fi
-
-    # TanStack Start
-    if has_dep "@tanstack/start"; then echo "tanstack-start"; return; fi
-
-    # Astro
-    if has_dep "astro"; then echo "astro"; return; fi
-
-    # Hydrogen (Shopify)
-    if has_dep "@shopify/hydrogen"; then echo "hydrogen"; return; fi
-
-    # SvelteKit
-    if has_dep "@sveltejs/kit"; then echo "sveltekit-1"; return; fi
-
-    # Svelte (standalone)
-    if has_dep "svelte"; then echo "svelte"; return; fi
-
-    # Nuxt
-    if has_dep "nuxt"; then echo "nuxtjs"; return; fi
-
-    # Vue with Vitepress
-    if has_dep "vitepress"; then echo "vitepress"; return; fi
-
-    # Vue with Vuepress
-    if has_dep "vuepress"; then echo "vuepress"; return; fi
-
-    # Gridsome
-    if has_dep "gridsome"; then echo "gridsome"; return; fi
-
-    # SolidStart
-    if has_dep "@solidjs/start"; then echo "solidstart-1"; return; fi
-
-    # Docusaurus
-    if has_dep "@docusaurus/core"; then echo "docusaurus-2"; return; fi
-
-    # RedwoodJS
-    if has_dep "@redwoodjs/"; then echo "redwoodjs"; return; fi
-
-    # Hexo
-    if has_dep "hexo"; then echo "hexo"; return; fi
-
-    # Eleventy
-    if has_dep "@11ty/eleventy"; then echo "eleventy"; return; fi
-
-    # Angular / Ionic Angular
-    if has_dep "@ionic/angular"; then echo "ionic-angular"; return; fi
-    if has_dep "@angular/core"; then echo "angular"; return; fi
-
-    # Ionic React
-    if has_dep "@ionic/react"; then echo "ionic-react"; return; fi
-
-    # Create React App
-    if has_dep "react-scripts"; then echo "create-react-app"; return; fi
-
-    # Ember
-    if has_dep "ember-cli" || has_dep "ember-source"; then echo "ember"; return; fi
-
-    # Dojo
-    if has_dep "@dojo/framework"; then echo "dojo"; return; fi
-
-    # Polymer
-    if has_dep "@polymer/"; then echo "polymer"; return; fi
-
-    # Preact
-    if has_dep "preact"; then echo "preact"; return; fi
-
-    # Stencil
-    if has_dep "@stencil/core"; then echo "stencil"; return; fi
-
-    # UmiJS
-    if has_dep "umi"; then echo "umijs"; return; fi
-
-    # Sapper (legacy Svelte)
-    if has_dep "sapper"; then echo "sapper"; return; fi
-
-    # Saber
-    if has_dep "saber"; then echo "saber"; return; fi
-
-    # Sanity
-    if has_dep "sanity"; then echo "sanity-v3"; return; fi
-    if has_dep "@sanity/"; then echo "sanity"; return; fi
-
-    # Storybook
-    if has_dep "@storybook/"; then echo "storybook"; return; fi
-
-    # NestJS
-    if has_dep "@nestjs/core"; then echo "nestjs"; return; fi
-
-    # Elysia
-    if has_dep "elysia"; then echo "elysia"; return; fi
-
-    # Hono
-    if has_dep "hono"; then echo "hono"; return; fi
-
-    # Fastify
-    if has_dep "fastify"; then echo "fastify"; return; fi
-
-    # h3
-    if has_dep "h3"; then echo "h3"; return; fi
-
-    # Nitro
-    if has_dep "nitropack"; then echo "nitro"; return; fi
-
-    # Express
-    if has_dep "express"; then echo "express"; return; fi
-
-    # Vite (generic - check last among JS frameworks)
-    if has_dep "vite"; then echo "vite"; return; fi
-
-    # Parcel
-    if has_dep "parcel"; then echo "parcel"; return; fi
-
-    # No framework detected
-    echo "null"
-}
-
-# Parse arguments
-INPUT_PATH="${1:-.}"
-
-# Create temp directory for packaging
-TEMP_DIR=$(mktemp -d)
-TARBALL="$TEMP_DIR/project.tgz"
-CLEANUP_TEMP=true
-
-cleanup() {
-    if [ "$CLEANUP_TEMP" = true ]; then
-        rm -rf "$TEMP_DIR"
-    fi
-}
-trap cleanup EXIT
-
-echo "Preparing deployment..." >&2
-
-# Check if input is a .tgz file or a directory
-FRAMEWORK="null"
-
-if [ -f "$INPUT_PATH" ] && [[ "$INPUT_PATH" == *.tgz ]]; then
-    # Input is already a tarball, use it directly
-    echo "Using provided tarball..." >&2
-    TARBALL="$INPUT_PATH"
-    CLEANUP_TEMP=false
-    # Can't detect framework from tarball, leave as null
-elif [ -d "$INPUT_PATH" ]; then
-    # Input is a directory, need to tar it
-    PROJECT_PATH=$(cd "$INPUT_PATH" && pwd)
-
-    # Detect framework from package.json
-    FRAMEWORK=$(detect_framework "$PROJECT_PATH/package.json")
-
-    # Check if this is a static HTML project (no package.json)
-    if [ ! -f "$PROJECT_PATH/package.json" ]; then
-        # Find HTML files in root
-        HTML_FILES=$(find "$PROJECT_PATH" -maxdepth 1 -name "*.html" -type f)
-        HTML_COUNT=$(echo "$HTML_FILES" | grep -c . || echo 0)
-
-        # If there's exactly one HTML file and it's not index.html, rename it
-        if [ "$HTML_COUNT" -eq 1 ]; then
-            HTML_FILE=$(echo "$HTML_FILES" | head -1)
-            BASENAME=$(basename "$HTML_FILE")
-            if [ "$BASENAME" != "index.html" ]; then
-                echo "Renaming $BASENAME to index.html..." >&2
-                mv "$HTML_FILE" "$PROJECT_PATH/index.html"
-            fi
-        fi
-    fi
-
-    # Create tarball of the project (excluding node_modules and .git)
-    echo "Creating deployment package..." >&2
-    tar -czf "$TARBALL" -C "$PROJECT_PATH" --exclude='node_modules' --exclude='.git' .
-else
-    echo "Error: Input must be a directory or a .tgz file" >&2
-    exit 1
-fi
-
-if [ "$FRAMEWORK" != "null" ]; then
-    echo "Detected framework: $FRAMEWORK" >&2
-fi
-
-# Deploy
-echo "Deploying..." >&2
-RESPONSE=$(curl -s -X POST "$DEPLOY_ENDPOINT" -F "file=@$TARBALL" -F "framework=$FRAMEWORK")
-
-# Check for error in response
-if echo "$RESPONSE" | grep -q '"error"'; then
-    ERROR_MSG=$(echo "$RESPONSE" | grep -o '"error":"[^"]*"' | cut -d'"' -f4)
-    echo "Error: $ERROR_MSG" >&2
-    exit 1
-fi
-
-# Extract URLs from response
-PREVIEW_URL=$(echo "$RESPONSE" | grep -o '"previewUrl":"[^"]*"' | cut -d'"' -f4)
-CLAIM_URL=$(echo "$RESPONSE" | grep -o '"claimUrl":"[^"]*"' | cut -d'"' -f4)
-
-if [ -z "$PREVIEW_URL" ]; then
-    echo "Error: Could not extract preview URL from response" >&2
-    echo "$RESPONSE" >&2
-    exit 1
-fi
-
-echo "" >&2
-echo "Deployment successful!" >&2
-echo "" >&2
-echo "Preview URL: $PREVIEW_URL" >&2
-echo "Claim URL:   $CLAIM_URL" >&2
-echo "" >&2
-
-# Output JSON for programmatic use
-echo "$RESPONSE"

package/.codex/skills/vercel-deploy/SKILL.md

@@ -1,109 +0,0 @@
----
-name: vercel-deploy
-description: Deploy applications and websites to Vercel. Use this skill when the user requests deployment actions such as "Deploy my app", "Deploy this to production", "Create a preview deployment", "Deploy and give me the link", or "Push this live". No authentication required - returns preview URL and claimable deployment link.
----
-
-# Vercel Deploy
-
-Deploy any project to Vercel instantly. No authentication required.
-
-## How It Works
-
-1. Packages your project into a tarball (excludes `node_modules` and `.git`)
-2. Auto-detects framework from `package.json`
-3. Uploads to deployment service
-4. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
-
-## Usage
-
-```bash
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
-```
-
-**Arguments:**
-- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
-
-**Examples:**
-
-```bash
-# Deploy current directory
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh
-
-# Deploy specific project
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project
-
-# Deploy existing tarball
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
-```
-
-## Output
-
-```
-Preparing deployment...
-Detected framework: nextjs
-Creating deployment package...
-Deploying...
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-```
-
-The script also outputs JSON to stdout for programmatic use:
-
-```json
-{
-  "previewUrl": "https://skill-deploy-abc123.vercel.app",
-  "claimUrl": "https://vercel.com/claim-deployment?code=...",
-  "deploymentId": "dpl_...",
-  "projectId": "prj_..."
-}
-```
-
-## Framework Detection
-
-The script auto-detects frameworks from `package.json`. Supported frameworks include:
-
-- **React**: Next.js, Gatsby, Create React App, Remix, React Router
-- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
-- **Svelte**: SvelteKit, Svelte, Sapper
-- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
-- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
-- **Build Tools**: Vite, Parcel
-- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
-
-For static HTML projects (no `package.json`), framework is set to `null`.
-
-## Static HTML Projects
-
-For projects without a `package.json`:
-- If there's a single `.html` file not named `index.html`, it gets renamed automatically
-- This ensures the page is served at the root URL (`/`)
-
-## Present Results to User
-
-Always show both URLs:
-
-```
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-
-View your site at the Preview URL.
-To transfer this deployment to your Vercel account, visit the Claim URL.
-```
-
-## Troubleshooting
-
-### Network Egress Error
-
-If deployment fails due to network restrictions (common on claude.ai), tell the user:
-
-```
-Deployment failed due to network restrictions. To fix this:
-
-1. Go to https://claude.ai/admin-settings/capabilities
-2. Add *.vercel.com to the allowed domains
-3. Try deploying again
-```

package/.codex/skills/vercel-deploy/scripts/deploy.sh

@@ -1,249 +0,0 @@
-#!/bin/bash
-
-# Vercel Deployment Script (via claimable deploy endpoint)
-# Usage: ./deploy.sh [project-path]
-# Returns: JSON with previewUrl, claimUrl, deploymentId, projectId
-
-set -e
-
-DEPLOY_ENDPOINT="https://claude-skills-deploy.vercel.com/api/deploy"
-
-# Detect framework from package.json
-detect_framework() {
-    local pkg_json="$1"
-
-    if [ ! -f "$pkg_json" ]; then
-        echo "null"
-        return
-    fi
-
-    local content=$(cat "$pkg_json")
-
-    # Helper to check if a package exists in dependencies or devDependencies
-    has_dep() {
-        echo "$content" | grep -q "\"$1\""
-    }
-
-    # Order matters - check more specific frameworks first
-
-    # Blitz
-    if has_dep "blitz"; then echo "blitzjs"; return; fi
-
-    # Next.js
-    if has_dep "next"; then echo "nextjs"; return; fi
-
-    # Gatsby
-    if has_dep "gatsby"; then echo "gatsby"; return; fi
-
-    # Remix
-    if has_dep "@remix-run/"; then echo "remix"; return; fi
-
-    # React Router (v7 framework mode)
-    if has_dep "@react-router/"; then echo "react-router"; return; fi
-
-    # TanStack Start
-    if has_dep "@tanstack/start"; then echo "tanstack-start"; return; fi
-
-    # Astro
-    if has_dep "astro"; then echo "astro"; return; fi
-
-    # Hydrogen (Shopify)
-    if has_dep "@shopify/hydrogen"; then echo "hydrogen"; return; fi
-
-    # SvelteKit
-    if has_dep "@sveltejs/kit"; then echo "sveltekit-1"; return; fi
-
-    # Svelte (standalone)
-    if has_dep "svelte"; then echo "svelte"; return; fi
-
-    # Nuxt
-    if has_dep "nuxt"; then echo "nuxtjs"; return; fi
-
-    # Vue with Vitepress
-    if has_dep "vitepress"; then echo "vitepress"; return; fi
-
-    # Vue with Vuepress
-    if has_dep "vuepress"; then echo "vuepress"; return; fi
-
-    # Gridsome
-    if has_dep "gridsome"; then echo "gridsome"; return; fi
-
-    # SolidStart
-    if has_dep "@solidjs/start"; then echo "solidstart-1"; return; fi
-
-    # Docusaurus
-    if has_dep "@docusaurus/core"; then echo "docusaurus-2"; return; fi
-
-    # RedwoodJS
-    if has_dep "@redwoodjs/"; then echo "redwoodjs"; return; fi
-
-    # Hexo
-    if has_dep "hexo"; then echo "hexo"; return; fi
-
-    # Eleventy
-    if has_dep "@11ty/eleventy"; then echo "eleventy"; return; fi
-
-    # Angular / Ionic Angular
-    if has_dep "@ionic/angular"; then echo "ionic-angular"; return; fi
-    if has_dep "@angular/core"; then echo "angular"; return; fi
-
-    # Ionic React
-    if has_dep "@ionic/react"; then echo "ionic-react"; return; fi
-
-    # Create React App
-    if has_dep "react-scripts"; then echo "create-react-app"; return; fi
-
-    # Ember
-    if has_dep "ember-cli" || has_dep "ember-source"; then echo "ember"; return; fi
-
-    # Dojo
-    if has_dep "@dojo/framework"; then echo "dojo"; return; fi
-
-    # Polymer
-    if has_dep "@polymer/"; then echo "polymer"; return; fi
-
-    # Preact
-    if has_dep "preact"; then echo "preact"; return; fi
-
-    # Stencil
-    if has_dep "@stencil/core"; then echo "stencil"; return; fi
-
-    # UmiJS
-    if has_dep "umi"; then echo "umijs"; return; fi
-
-    # Sapper (legacy Svelte)
-    if has_dep "sapper"; then echo "sapper"; return; fi
-
-    # Saber
-    if has_dep "saber"; then echo "saber"; return; fi
-
-    # Sanity
-    if has_dep "sanity"; then echo "sanity-v3"; return; fi
-    if has_dep "@sanity/"; then echo "sanity"; return; fi
-
-    # Storybook
-    if has_dep "@storybook/"; then echo "storybook"; return; fi
-
-    # NestJS
-    if has_dep "@nestjs/core"; then echo "nestjs"; return; fi
-
-    # Elysia
-    if has_dep "elysia"; then echo "elysia"; return; fi
-
-    # Hono
-    if has_dep "hono"; then echo "hono"; return; fi
-
-    # Fastify
-    if has_dep "fastify"; then echo "fastify"; return; fi
-
-    # h3
-    if has_dep "h3"; then echo "h3"; return; fi
-
-    # Nitro
-    if has_dep "nitropack"; then echo "nitro"; return; fi
-
-    # Express
-    if has_dep "express"; then echo "express"; return; fi
-
-    # Vite (generic - check last among JS frameworks)
-    if has_dep "vite"; then echo "vite"; return; fi
-
-    # Parcel
-    if has_dep "parcel"; then echo "parcel"; return; fi
-
-    # No framework detected
-    echo "null"
-}
-
-# Parse arguments
-INPUT_PATH="${1:-.}"
-
-# Create temp directory for packaging
-TEMP_DIR=$(mktemp -d)
-TARBALL="$TEMP_DIR/project.tgz"
-CLEANUP_TEMP=true
-
-cleanup() {
-    if [ "$CLEANUP_TEMP" = true ]; then
-        rm -rf "$TEMP_DIR"
-    fi
-}
-trap cleanup EXIT
-
-echo "Preparing deployment..." >&2
-
-# Check if input is a .tgz file or a directory
-FRAMEWORK="null"
-
-if [ -f "$INPUT_PATH" ] && [[ "$INPUT_PATH" == *.tgz ]]; then
-    # Input is already a tarball, use it directly
-    echo "Using provided tarball..." >&2
-    TARBALL="$INPUT_PATH"
-    CLEANUP_TEMP=false
-    # Can't detect framework from tarball, leave as null
-elif [ -d "$INPUT_PATH" ]; then
-    # Input is a directory, need to tar it
-    PROJECT_PATH=$(cd "$INPUT_PATH" && pwd)
-
-    # Detect framework from package.json
-    FRAMEWORK=$(detect_framework "$PROJECT_PATH/package.json")
-
-    # Check if this is a static HTML project (no package.json)
-    if [ ! -f "$PROJECT_PATH/package.json" ]; then
-        # Find HTML files in root
-        HTML_FILES=$(find "$PROJECT_PATH" -maxdepth 1 -name "*.html" -type f)
-        HTML_COUNT=$(echo "$HTML_FILES" | grep -c . || echo 0)
-
-        # If there's exactly one HTML file and it's not index.html, rename it
-        if [ "$HTML_COUNT" -eq 1 ]; then
-            HTML_FILE=$(echo "$HTML_FILES" | head -1)
-            BASENAME=$(basename "$HTML_FILE")
-            if [ "$BASENAME" != "index.html" ]; then
-                echo "Renaming $BASENAME to index.html..." >&2
-                mv "$HTML_FILE" "$PROJECT_PATH/index.html"
-            fi
-        fi
-    fi
-
-    # Create tarball of the project (excluding node_modules and .git)
-    echo "Creating deployment package..." >&2
-    tar -czf "$TARBALL" -C "$PROJECT_PATH" --exclude='node_modules' --exclude='.git' .
-else
-    echo "Error: Input must be a directory or a .tgz file" >&2
-    exit 1
-fi
-
-if [ "$FRAMEWORK" != "null" ]; then
-    echo "Detected framework: $FRAMEWORK" >&2
-fi
-
-# Deploy
-echo "Deploying..." >&2
-RESPONSE=$(curl -s -X POST "$DEPLOY_ENDPOINT" -F "file=@$TARBALL" -F "framework=$FRAMEWORK")
-
-# Check for error in response
-if echo "$RESPONSE" | grep -q '"error"'; then
-    ERROR_MSG=$(echo "$RESPONSE" | grep -o '"error":"[^"]*"' | cut -d'"' -f4)
-    echo "Error: $ERROR_MSG" >&2
-    exit 1
-fi
-
-# Extract URLs from response
-PREVIEW_URL=$(echo "$RESPONSE" | grep -o '"previewUrl":"[^"]*"' | cut -d'"' -f4)
-CLAIM_URL=$(echo "$RESPONSE" | grep -o '"claimUrl":"[^"]*"' | cut -d'"' -f4)
-
-if [ -z "$PREVIEW_URL" ]; then
-    echo "Error: Could not extract preview URL from response" >&2
-    echo "$RESPONSE" >&2
-    exit 1
-fi
-
-echo "" >&2
-echo "Deployment successful!" >&2
-echo "" >&2
-echo "Preview URL: $PREVIEW_URL" >&2
-echo "Claim URL:   $CLAIM_URL" >&2
-echo "" >&2
-
-# Output JSON for programmatic use
-echo "$RESPONSE"

package/.opencode/skill/vercel-deploy/SKILL.md

@@ -1,109 +0,0 @@
----
-name: vercel-deploy
-description: Deploy applications and websites to Vercel. Use this skill when the user requests deployment actions such as "Deploy my app", "Deploy this to production", "Create a preview deployment", "Deploy and give me the link", or "Push this live". No authentication required - returns preview URL and claimable deployment link.
----
-
-# Vercel Deploy
-
-Deploy any project to Vercel instantly. No authentication required.
-
-## How It Works
-
-1. Packages your project into a tarball (excludes `node_modules` and `.git`)
-2. Auto-detects framework from `package.json`
-3. Uploads to deployment service
-4. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
-
-## Usage
-
-```bash
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
-```
-
-**Arguments:**
-- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
-
-**Examples:**
-
-```bash
-# Deploy current directory
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh
-
-# Deploy specific project
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project
-
-# Deploy existing tarball
-bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
-```
-
-## Output
-
-```
-Preparing deployment...
-Detected framework: nextjs
-Creating deployment package...
-Deploying...
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-```
-
-The script also outputs JSON to stdout for programmatic use:
-
-```json
-{
-  "previewUrl": "https://skill-deploy-abc123.vercel.app",
-  "claimUrl": "https://vercel.com/claim-deployment?code=...",
-  "deploymentId": "dpl_...",
-  "projectId": "prj_..."
-}
-```
-
-## Framework Detection
-
-The script auto-detects frameworks from `package.json`. Supported frameworks include:
-
-- **React**: Next.js, Gatsby, Create React App, Remix, React Router
-- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
-- **Svelte**: SvelteKit, Svelte, Sapper
-- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
-- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
-- **Build Tools**: Vite, Parcel
-- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
-
-For static HTML projects (no `package.json`), framework is set to `null`.
-
-## Static HTML Projects
-
-For projects without a `package.json`:
-- If there's a single `.html` file not named `index.html`, it gets renamed automatically
-- This ensures the page is served at the root URL (`/`)
-
-## Present Results to User
-
-Always show both URLs:
-
-```
-✓ Deployment successful!
-
-Preview URL: https://skill-deploy-abc123.vercel.app
-Claim URL:   https://vercel.com/claim-deployment?code=...
-
-View your site at the Preview URL.
-To transfer this deployment to your Vercel account, visit the Claim URL.
-```
-
-## Troubleshooting
-
-### Network Egress Error
-
-If deployment fails due to network restrictions (common on claude.ai), tell the user:
-
-```
-Deployment failed due to network restrictions. To fix this:
-
-1. Go to https://claude.ai/admin-settings/capabilities
-2. Add *.vercel.com to the allowed domains
-3. Try deploying again
-```

package/.opencode/skill/vercel-deploy/scripts/deploy.sh

@@ -1,249 +0,0 @@
-#!/bin/bash
-
-# Vercel Deployment Script (via claimable deploy endpoint)
-# Usage: ./deploy.sh [project-path]
-# Returns: JSON with previewUrl, claimUrl, deploymentId, projectId
-
-set -e
-
-DEPLOY_ENDPOINT="https://claude-skills-deploy.vercel.com/api/deploy"
-
-# Detect framework from package.json
-detect_framework() {
-    local pkg_json="$1"
-
-    if [ ! -f "$pkg_json" ]; then
-        echo "null"
-        return
-    fi
-
-    local content=$(cat "$pkg_json")
-
-    # Helper to check if a package exists in dependencies or devDependencies
-    has_dep() {
-        echo "$content" | grep -q "\"$1\""
-    }
-
-    # Order matters - check more specific frameworks first
-
-    # Blitz
-    if has_dep "blitz"; then echo "blitzjs"; return; fi
-
-    # Next.js
-    if has_dep "next"; then echo "nextjs"; return; fi
-
-    # Gatsby
-    if has_dep "gatsby"; then echo "gatsby"; return; fi
-
-    # Remix
-    if has_dep "@remix-run/"; then echo "remix"; return; fi
-
-    # React Router (v7 framework mode)
-    if has_dep "@react-router/"; then echo "react-router"; return; fi
-
-    # TanStack Start
-    if has_dep "@tanstack/start"; then echo "tanstack-start"; return; fi
-
-    # Astro
-    if has_dep "astro"; then echo "astro"; return; fi
-
-    # Hydrogen (Shopify)
-    if has_dep "@shopify/hydrogen"; then echo "hydrogen"; return; fi
-
-    # SvelteKit
-    if has_dep "@sveltejs/kit"; then echo "sveltekit-1"; return; fi
-
-    # Svelte (standalone)
-    if has_dep "svelte"; then echo "svelte"; return; fi
-
-    # Nuxt
-    if has_dep "nuxt"; then echo "nuxtjs"; return; fi
-
-    # Vue with Vitepress
-    if has_dep "vitepress"; then echo "vitepress"; return; fi
-
-    # Vue with Vuepress
-    if has_dep "vuepress"; then echo "vuepress"; return; fi
-
-    # Gridsome
-    if has_dep "gridsome"; then echo "gridsome"; return; fi
-
-    # SolidStart
-    if has_dep "@solidjs/start"; then echo "solidstart-1"; return; fi
-
-    # Docusaurus
-    if has_dep "@docusaurus/core"; then echo "docusaurus-2"; return; fi
-
-    # RedwoodJS
-    if has_dep "@redwoodjs/"; then echo "redwoodjs"; return; fi
-
-    # Hexo
-    if has_dep "hexo"; then echo "hexo"; return; fi
-
-    # Eleventy
-    if has_dep "@11ty/eleventy"; then echo "eleventy"; return; fi
-
-    # Angular / Ionic Angular
-    if has_dep "@ionic/angular"; then echo "ionic-angular"; return; fi
-    if has_dep "@angular/core"; then echo "angular"; return; fi
-
-    # Ionic React
-    if has_dep "@ionic/react"; then echo "ionic-react"; return; fi
-
-    # Create React App
-    if has_dep "react-scripts"; then echo "create-react-app"; return; fi
-
-    # Ember
-    if has_dep "ember-cli" || has_dep "ember-source"; then echo "ember"; return; fi
-
-    # Dojo
-    if has_dep "@dojo/framework"; then echo "dojo"; return; fi
-
-    # Polymer
-    if has_dep "@polymer/"; then echo "polymer"; return; fi
-
-    # Preact
-    if has_dep "preact"; then echo "preact"; return; fi
-
-    # Stencil
-    if has_dep "@stencil/core"; then echo "stencil"; return; fi
-
-    # UmiJS
-    if has_dep "umi"; then echo "umijs"; return; fi
-
-    # Sapper (legacy Svelte)
-    if has_dep "sapper"; then echo "sapper"; return; fi
-
-    # Saber
-    if has_dep "saber"; then echo "saber"; return; fi
-
-    # Sanity
-    if has_dep "sanity"; then echo "sanity-v3"; return; fi
-    if has_dep "@sanity/"; then echo "sanity"; return; fi
-
-    # Storybook
-    if has_dep "@storybook/"; then echo "storybook"; return; fi
-
-    # NestJS
-    if has_dep "@nestjs/core"; then echo "nestjs"; return; fi
-
-    # Elysia
-    if has_dep "elysia"; then echo "elysia"; return; fi
-
-    # Hono
-    if has_dep "hono"; then echo "hono"; return; fi
-
-    # Fastify
-    if has_dep "fastify"; then echo "fastify"; return; fi
-
-    # h3
-    if has_dep "h3"; then echo "h3"; return; fi
-
-    # Nitro
-    if has_dep "nitropack"; then echo "nitro"; return; fi
-
-    # Express
-    if has_dep "express"; then echo "express"; return; fi
-
-    # Vite (generic - check last among JS frameworks)
-    if has_dep "vite"; then echo "vite"; return; fi
-
-    # Parcel
-    if has_dep "parcel"; then echo "parcel"; return; fi
-
-    # No framework detected
-    echo "null"
-}
-
-# Parse arguments
-INPUT_PATH="${1:-.}"
-
-# Create temp directory for packaging
-TEMP_DIR=$(mktemp -d)
-TARBALL="$TEMP_DIR/project.tgz"
-CLEANUP_TEMP=true
-
-cleanup() {
-    if [ "$CLEANUP_TEMP" = true ]; then
-        rm -rf "$TEMP_DIR"
-    fi
-}
-trap cleanup EXIT
-
-echo "Preparing deployment..." >&2
-
-# Check if input is a .tgz file or a directory
-FRAMEWORK="null"
-
-if [ -f "$INPUT_PATH" ] && [[ "$INPUT_PATH" == *.tgz ]]; then
-    # Input is already a tarball, use it directly
-    echo "Using provided tarball..." >&2
-    TARBALL="$INPUT_PATH"
-    CLEANUP_TEMP=false
-    # Can't detect framework from tarball, leave as null
-elif [ -d "$INPUT_PATH" ]; then
-    # Input is a directory, need to tar it
-    PROJECT_PATH=$(cd "$INPUT_PATH" && pwd)
-
-    # Detect framework from package.json
-    FRAMEWORK=$(detect_framework "$PROJECT_PATH/package.json")
-
-    # Check if this is a static HTML project (no package.json)
-    if [ ! -f "$PROJECT_PATH/package.json" ]; then
-        # Find HTML files in root
-        HTML_FILES=$(find "$PROJECT_PATH" -maxdepth 1 -name "*.html" -type f)
-        HTML_COUNT=$(echo "$HTML_FILES" | grep -c . || echo 0)
-
-        # If there's exactly one HTML file and it's not index.html, rename it
-        if [ "$HTML_COUNT" -eq 1 ]; then
-            HTML_FILE=$(echo "$HTML_FILES" | head -1)
-            BASENAME=$(basename "$HTML_FILE")
-            if [ "$BASENAME" != "index.html" ]; then
-                echo "Renaming $BASENAME to index.html..." >&2
-                mv "$HTML_FILE" "$PROJECT_PATH/index.html"
-            fi
-        fi
-    fi
-
-    # Create tarball of the project (excluding node_modules and .git)
-    echo "Creating deployment package..." >&2
-    tar -czf "$TARBALL" -C "$PROJECT_PATH" --exclude='node_modules' --exclude='.git' .
-else
-    echo "Error: Input must be a directory or a .tgz file" >&2
-    exit 1
-fi
-
-if [ "$FRAMEWORK" != "null" ]; then
-    echo "Detected framework: $FRAMEWORK" >&2
-fi
-
-# Deploy
-echo "Deploying..." >&2
-RESPONSE=$(curl -s -X POST "$DEPLOY_ENDPOINT" -F "file=@$TARBALL" -F "framework=$FRAMEWORK")
-
-# Check for error in response
-if echo "$RESPONSE" | grep -q '"error"'; then
-    ERROR_MSG=$(echo "$RESPONSE" | grep -o '"error":"[^"]*"' | cut -d'"' -f4)
-    echo "Error: $ERROR_MSG" >&2
-    exit 1
-fi
-
-# Extract URLs from response
-PREVIEW_URL=$(echo "$RESPONSE" | grep -o '"previewUrl":"[^"]*"' | cut -d'"' -f4)
-CLAIM_URL=$(echo "$RESPONSE" | grep -o '"claimUrl":"[^"]*"' | cut -d'"' -f4)
-
-if [ -z "$PREVIEW_URL" ]; then
-    echo "Error: Could not extract preview URL from response" >&2
-    echo "$RESPONSE" >&2
-    exit 1
-fi
-
-echo "" >&2
-echo "Deployment successful!" >&2
-echo "" >&2
-echo "Preview URL: $PREVIEW_URL" >&2
-echo "Claim URL:   $CLAIM_URL" >&2
-echo "" >&2
-
-# Output JSON for programmatic use
-echo "$RESPONSE"