@tinkcarlos/skillora 0.2.0

package/.claude/skills/using-skillstack/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: using-skillstack
+description: "Core skill that introduces the skillstack system. Auto-loaded at session start. Defines how to discover and use skills."
+---
+
+# Using Skillstack
+
+You have access to the **skillstack** skill system - a comprehensive library of proven workflows and best practices for software development.
+
+## The Iron Law of Skills
+
+**IF A SKILL MIGHT APPLY TO YOUR TASK, YOU MUST USE IT.**
+
+This is not optional. This is not a suggestion. Skills contain battle-tested workflows that prevent common mistakes and ensure quality.
+
+## How to Use Skills
+
+### In Claude Code
+Use the `Skill` tool or `/skill-name` command:
+```
+/bug-fixing
+/code-review
+/test-driven-development
+```
+
+### In Codex
+Run the CLI command:
+```bash
+skillstack-codex use-skill <skill-name>
+```
+
+### In Cursor
+Run in terminal:
+```bash
+skillstack read <skill-name>
+```
+
+## The Standard Development Workflow
+
+Follow this workflow for any significant feature:
+
+```
+1. /brainstorming          → Design the feature
+2. /using-git-worktrees    → Create isolated workspace
+3. /writing-plans          → Create implementation plan
+4. /subagent-driven-development → Execute plan with TDD
+5. /verification-before-completion → Verify everything works
+6. /finishing-a-development-branch → Merge/PR
+```
+
+## Available Skills
+
+### Workflow Skills (Superpowers-compatible)
+- `brainstorming` - Turn ideas into designs through dialogue
+- `using-git-worktrees` - Create isolated development environments
+- `writing-plans` - Create detailed implementation plans
+- `subagent-driven-development` - Execute plans with fresh subagents
+- `test-driven-development` - RED-GREEN-REFACTOR cycle
+- `verification-before-completion` - Verify before declaring done
+- `finishing-a-development-branch` - Complete and merge branches
+
+### Core Development
+- `bug-fixing` - Zero-regression bug fixing with root cause analysis
+- `code-review` - Exhaustive code review with multi-skill standards
+- `fullstack-developer` - Full-stack development with mandatory review
+- `frontend-design` - Production-grade frontend interfaces
+
+### Testing
+- `test-driven-development` - Strict TDD with Iron Law
+- `webapp-testing` - Web application testing strategies
+- `test-architect-live` - Test architecture design
+
+### Planning & Design
+- `brainstorming` - Collaborative design exploration
+- `product-requirements` - Product requirements documentation
+- `project-development` - Project development planning
+
+### Documentation
+- `doc-coauthoring` - Collaborative documentation writing
+
+### Specialized
+- `mcp-builder` - Building MCP servers
+- `postgresql` - PostgreSQL database patterns
+- `p-master-fusion` - Prompt engineering
+- `skill-creator` - Create new skills
+
+## When to Load a Skill
+
+| Task | Skill |
+|------|-------|
+| Starting a new feature | `/brainstorming` |
+| Setting up workspace | `/using-git-worktrees` |
+| Planning implementation | `/writing-plans` |
+| Writing code | `/test-driven-development` |
+| Fixing a bug | `/bug-fixing` |
+| Reviewing code | `/code-review` |
+| Building UI | `/frontend-design` |
+| Finishing feature | `/verification-before-completion` |
+
+**Even if there's only a 1% chance a skill applies, load it and check.**
+
+## Skill Priority
+
+Skills are loaded in priority order:
+1. **Project skills** - `.claude/skills/` in current project
+2. **Personal skills** - `~/.claude/skills/` or `~/.codex/skills/`
+3. **Skillstack skills** - Built-in skillstack library
+
+Use `skillstack:skill-name` prefix to force loading from skillstack.
+
+## Red Flags - You're Violating the Iron Law If:
+
+- You start coding without checking for relevant skills
+- You think "this is simple, I don't need a skill"
+- You rationalize skipping a skill because "it will slow me down"
+- You assume you know better than the skill's workflow
+- You write code before writing tests
+
+## Remember
+
+Skills are not suggestions. They are proven workflows that:
+- Prevent common mistakes
+- Ensure consistent quality
+- Save time by avoiding rework
+- Capture institutional knowledge
+
+**When in doubt, load the skill.**

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

@@ -0,0 +1,166 @@
+---
+name: vercel-deploy
+description: |
+  Deploy applications and websites to Vercel instantly.
+
+  Use when:
+  - "Deploy my app"
+  - "Deploy this to production"
+  - "Create a preview deployment"
+  - "Deploy and give me the link"
+  - "Push this live"
+
+  Key Features:
+  - No authentication required
+  - Auto-detects 40+ frameworks from package.json
+  - Returns preview URL and claimable deployment link
+  - Handles static HTML projects automatically
+
+  Note: This skill is designed for claude.ai environment.
+  For local CLI, use `vercel` CLI directly.
+allowed-tools: [read, write, execute, grep, glob]
+---
+
+# 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 scripts/deploy.sh [path]
+```
+
+**Arguments:**
+- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
+
+**Examples:**
+
+```bash
+# Deploy current directory
+bash scripts/deploy.sh
+
+# Deploy specific project
+bash scripts/deploy.sh /path/to/project
+
+# Deploy existing tarball
+bash 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=...
+```
+
+**JSON output 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`:
+
+| Category | Frameworks |
+|----------|------------|
+| **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):
+
+```
+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
+```
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| "Could not extract preview URL" | Check network connectivity |
+| "Input must be a directory or .tgz" | Verify path exists |
+| Framework not detected | Add package.json or specify framework |
+
+---
+
+## Alternative: Local Vercel CLI
+
+For local development, use the official Vercel CLI:
+
+```bash
+# Install
+npm i -g vercel
+
+# Deploy
+vercel
+
+# Deploy to production
+vercel --prod
+```

package/.claude/skills/vercel-deploy/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"