codexkit 1.0.0

package/.codex/skills/v1-run/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: v1-run
+description: npm package intelligence via MCP. Real-time versions, vulnerability data, health scores, and package comparisons. Use when selecting npm packages, checking for vulnerabilities, or comparing alternatives.
+version: 1.0.0
+tags: [integration, mcp, research]
+dependencies: []
+---
+
+# v1.run MCP
+
+## When to Use
+
+- When you need real-time npm package health, vulnerabilities, or comparisons.
+
+## When NOT to Use
+
+- When package selection or security analysis is not in scope.
+
+
+## Overview
+
+v1.run is an MCP-first npm registry by Midday.ai that provides:
+
+- **Real-time version data** - No hallucinated packages
+- **Security vulnerabilities** - From OSV database
+- **Health scores** - Automated 0-100 scoring
+- **Package comparisons** - 50+ pre-built categories
+
+## MCP Endpoint
+
+**URL**: `https://api.v1.run/mcp`
+
+**Authentication**: None required (public API)
+
+## Configuration
+
+v1.run MCP is pre-configured as a skill. Load it with:
+
+```typescript
+skill({ name: "v1-run" });
+```
+
+### Manual Setup (if needed)
+
+```json
+{
+  "mcpServers": {
+    "v1": {
+      "url": "https://api.v1.run/mcp"
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool                    | Description                                                                                                       |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `get_package_health`    | Comprehensive health assessment (primary tool) - version, vulns, score, downloads, TS support, AI recommendations |
+| `get_package_version`   | Get latest version of a package                                                                                   |
+| `check_deprecated`      | Check if package is deprecated + get alternatives                                                                 |
+| `check_types`           | Check TypeScript support (bundled or @types)                                                                      |
+| `check_vulnerabilities` | Security vulnerabilities from OSV database                                                                        |
+| `find_alternatives`     | Find alternative packages with recommendations                                                                    |
+| `compare_packages`      | Side-by-side comparison (2-5 packages)                                                                            |
+
+## Health Score System
+
+Packages are scored 0-100 based on:
+
+| Factor      | Weight | Measures                                |
+| ----------- | ------ | --------------------------------------- |
+| Downloads   | 20%    | Weekly downloads + trend direction      |
+| Bundle Size | 20%    | Smaller gzip = higher score             |
+| Freshness   | 25%    | Recent commits and releases             |
+| Community   | 10%    | Stars, contributors                     |
+| Quality     | 25%    | TypeScript, ESM, security, tree-shaking |
+
+## Usage Examples
+
+### Check Package Health
+
+```typescript
+// Get comprehensive health info for a package (primary tool)
+skill_mcp({ skill_name: "v1-run", tool_name: "get_package_health", arguments: '{"name": "zod"}' });
+```
+
+Response includes:
+
+- Latest version
+- Known vulnerabilities (CVEs)
+- Health score (0-100) with grade
+- Weekly downloads + trend
+- TypeScript support
+- Maintenance status
+- AI recommendation
+
+### Check for Deprecation
+
+```typescript
+// Check if package is deprecated and get alternatives
+skill_mcp({
+  skill_name: "v1-run",
+  tool_name: "check_deprecated",
+  arguments: '{"name": "request"}',
+});
+```
+
+### Check Vulnerabilities
+
+```typescript
+// Check specific version for security issues
+skill_mcp({
+  skill_name: "v1-run",
+  tool_name: "check_vulnerabilities",
+  arguments: '{"name": "lodash", "version": "4.17.20"}',
+});
+```
+
+### Find Alternatives
+
+```typescript
+// Find alternative packages
+skill_mcp({
+  skill_name: "v1-run",
+  tool_name: "find_alternatives",
+  arguments: '{"name": "moment"}',
+});
+```
+
+### Compare Packages
+
+```typescript
+// Compare similar packages (2-5 packages)
+skill_mcp({
+  skill_name: "v1-run",
+  tool_name: "compare_packages",
+  arguments: '{"packages": ["zod", "yup", "joi", "valibot"]}',
+});
+```
+
+## Pre-built Categories (50+)
+
+v1.run includes comparisons for popular package categories:
+
+- **HTTP clients**: axios, got, ky, node-fetch
+- **Date libraries**: moment, date-fns, dayjs, luxon
+- **Validation**: zod, yup, joi, ajv, valibot
+- **State management**: redux, zustand, jotai, recoil
+- **ORM**: prisma, drizzle, typeorm, sequelize
+- **Testing**: vitest, jest, mocha, ava
+- **Bundlers**: vite, esbuild, webpack, rollup
+- **Logging**: pino, winston, bunyan
+
+## When to Use
+
+Use v1.run MCP when:
+
+1. **Choosing between packages** - Get objective comparisons
+2. **Checking for vulnerabilities** - Before adding dependencies
+3. **Evaluating maintenance** - Is the package actively maintained?
+4. **Finding alternatives** - Discover better options for a package
+
+## Best Practices
+
+1. **Always check health** before adding new dependencies
+2. **Compare alternatives** when multiple packages solve the same problem
+3. **Verify TypeScript support** for TypeScript projects
+4. **Check bundle size** for frontend applications
+
+## Documentation
+
+- [v1.run](https://v1.run)
+- [GitHub: midday-ai/v1](https://github.com/midday-ai/v1)
+- [MCP Documentation](https://modelcontextprotocol.io)

package/.codex/skills/v1-run/mcp.json

@@ -0,0 +1,6 @@
+{
+	"v1": {
+		"command": "npx",
+		"args": ["-y", "mcp-remote", "https://api.v1.run/mcp"]
+	}
+}

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

@@ -0,0 +1,124 @@
+---
+name: vercel-deploy-claimable
+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.
+version: 1.0.0
+tags: [devops, integration]
+dependencies: []
+metadata:
+  author: vercel
+  version: "1.0.0"
+---
+
+# Vercel Deploy
+
+## When to Use
+
+- When the user requests deploying a project to Vercel and needs preview/claim links.
+
+## When NOT to Use
+
+- When deployment is not requested or targets a non-Vercel platform.
+
+
+## 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/settings/capabilities
+2. Add *.vercel.com to the allowed domains
+3. Try deploying again
+```

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

@@ -0,0 +1,249 @@
+#!/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"