Skip to content

aiskillstore/marketplace / skills/abdulsamad94/deployment-build

deployment-build

Verified

Knowledge of the Vercel deployment pipeline, hybrid build scripts, and environment configuration.

FileKindSize
SKILL.mdskill md968 B
skill-report.jsonconfig20.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-18T09:45:19.814Z",
    "slug": "abdulsamad94-deployment-build",
    "source_url": "https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/deployment",
    "source_ref": "master",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "c8de8b63385aad087fab990105a1f6333cf77e28161dc22b9c755273c6e9c2f7",
    "tree_hash": "8505fdd0a2a8bf5e667e6bd5751845ec0966666d6c499e5e400b81eb96dd7a00",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-18T09:45:19.943428Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-18T09:45:19.964579Z ERROR codex_models_manage…"
        },
        {
          "agent": "claude",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "Deployment & Build",
    "description": "Guides deployment of a Next.js app with Docusaurus documentation and a FastAPI backend on Vercel.",
    "summary": "Plan and validate a hybrid Next.js, Docusaurus, and FastAPI deployment on Vercel.",
    "icon": "📦",
    "author": "AbdulSamad94",
    "license": "MIT",
    "tags": [
      "vercel",
      "nextjs",
      "docusaurus",
      "fastapi",
      "deployment"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "env_access"
    ],
    "category": "devops"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 17 static detections are false positives caused by Markdown code formatting and environment-variable names. The skill is documentation only; it does not execute commands, access environment values, transmit data, or contain prompt-injection language.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 12,
            "line_end": 12
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 14
          },
          {
            "file": "SKILL.md",
            "line_start": 15,
            "line_end": 15
          },
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 19,
            "line_end": 19
          },
          {
            "file": "SKILL.md",
            "line_start": 20,
            "line_end": 20
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 28,
            "line_end": 28
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "- **Build Command**: `npm run build`"
      },
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 12,
        "line_end": 12,
        "snippet": "1.  `cd textbook && npm install && npm run build` (Builds Docs)"
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "2.  `npx shx mkdir -p public/docs` (Creates output dir)"
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "3.  `npx shx cp -r textbook/build/* public/docs/` (Copies static docs to Next.js public folder)"
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 15,
        "line_end": 15,
        "snippet": "4.  `next build` (Builds the main Next.js app)"
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 18,
        "line_end": 18,
        "snippet": "- **File**: `backend/vercel.json`"
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 19,
        "line_end": 19,
        "snippet": "- **Python Runtime**: Used for the FastAPI backend (`backend/main.py`)."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 20,
        "line_end": 20,
        "snippet": "- **Routes**: Rewrites all `/api/*` requests to the Python function."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "- `GEMINI_API_KEY`"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 25,
        "snippet": "- `QDRANT_URL`"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "- `QDRANT_API_KEY`"
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 27,
        "line_end": 27,
        "snippet": "- `BETTER_AUTH_SECRET`"
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "- `NEXT_PUBLIC_APP_URL`"
      },
      {
        "id": "env_access:SKILL.md:24:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "- `GEMINI_API_KEY`"
      },
      {
        "id": "env_access:SKILL.md:26:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "- `QDRANT_API_KEY`"
      },
      {
        "id": "blocker:SKILL.md:3:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 3,
        "line_end": 3,
        "snippet": "description: Knowledge of the Vercel deployment pipeline, hybrid build scripts, and environment conf"
      },
      {
        "id": "blocker:SKILL.md:8:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 8,
        "line_end": 8,
        "snippet": "## Hybrid Build Process"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is Markdown documentation naming the standard npm build command. It does not execute a command or accept input."
      },
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a documented, fixed build sequence in Markdown. The skill contains no executable shell code or user-controlled command construction."
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a literal documentation command for creating a directory. It is not invoked by the skill and has no injection vector."
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a literal documentation command for copying built documentation. It is not executable code and contains no dynamic input."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a documented Next.js build command, not a shell execution statement. No command is run by the skill."
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a Markdown file-path reference, not command execution. It only describes the Vercel configuration location."
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a Markdown code reference to a Python source path. It does not invoke a shell or Python command."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a documented URL route pattern. It is not a shell command or executable instruction."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the name of a deployment environment variable. The skill does not read, transmit, or expose its value."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the name of a service URL variable in Markdown. It is not command execution and does not disclose a secret."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the name of an environment variable in deployment documentation. No command is invoked and no value is accessed."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the name of a secret configuration variable. The skill merely tells users to configure it in Vercel."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the name of a public application URL setting. It is documentation, not shell execution."
      },
      {
        "id": "env_access:SKILL.md:24:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The skill lists GEMINI_API_KEY as a required Vercel setting but contains no mechanism to read, send, or log its value."
      },
      {
        "id": "env_access:SKILL.md:26:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The skill lists QDRANT_API_KEY as a required Vercel setting but contains no mechanism to read, send, or log its value."
      },
      {
        "id": "blocker:SKILL.md:3:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The deployment-pipeline description is ordinary project documentation. It performs no host discovery or reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:8:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The Hybrid Build Process heading describes a build workflow only. It contains no system reconnaissance activity."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 29,
    "audit_model": "claude",
    "audited_at": "2026-07-18T09:45:19.814Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Deploy Your Hybrid App to Vercel",
    "value_statement": "Hybrid web applications can require separate build steps and deployment settings. This skill explains the documented build flow and required Vercel configuration.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Vercel deployment",
      "Next.js build",
      "Docusaurus",
      "FastAPI",
      "environment variables",
      "hybrid application"
    ],
    "actual_capabilities": [
      "Explains the documented build order for the Next.js and Docusaurus applications.",
      "Identifies the command that creates the public documentation directory.",
      "Describes copying generated documentation into the Next.js public directory.",
      "Summarizes the Vercel configuration path for the FastAPI backend.",
      "Lists the environment variable names required by the documented deployment."
    ],
    "limitations": [
      "It provides deployment guidance only and does not run builds or deployments.",
      "It does not validate Vercel project settings or environment variable values.",
      "It does not create backend configuration files or application code.",
      "It assumes the project uses the documented Next.js, Docusaurus, and FastAPI layout."
    ],
    "use_cases": [
      {
        "title": "Prepare a first Vercel deployment",
        "description": "Review the required build stages and environment variable names before deploying the documented application.",
        "target_user": "Full-stack developer"
      },
      {
        "title": "Troubleshoot missing documentation",
        "description": "Check whether the Docusaurus build output is copied into the expected Next.js public directory.",
        "target_user": "Frontend developer"
      },
      {
        "title": "Hand off deployment requirements",
        "description": "Share the backend route configuration and required Vercel settings with an operations teammate.",
        "target_user": "DevOps engineer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Review deployment steps",
        "scenario": "Beginner",
        "prompt": "Explain the documented build steps for this project in order and state what each step produces."
      },
      {
        "title": "List Vercel settings",
        "scenario": "Intermediate",
        "prompt": "List the environment variable names required for this deployment and explain where to configure them in Vercel."
      },
      {
        "title": "Diagnose documentation output",
        "scenario": "Intermediate",
        "prompt": "The documentation is missing after deployment. Use the documented build flow to identify the checks I should perform."
      },
      {
        "title": "Create a deployment checklist",
        "scenario": "Advanced",
        "prompt": "Create a pre-deployment checklist for the documented Next.js, Docusaurus, and FastAPI application. Separate build, Vercel, and secret configuration checks."
      }
    ],
    "output_examples": [
      {
        "input": "What happens during the hybrid build?",
        "output": [
          "Build the Docusaurus documentation application.",
          "Create the public/docs directory.",
          "Copy the documentation output into public/docs.",
          "Build the main Next.js application."
        ]
      },
      {
        "input": "What should I configure in Vercel?",
        "output": "Configure the documented environment variable names in the Vercel Dashboard and confirm backend/vercel.json routes API requests to the Python function."
      }
    ],
    "best_practices": [
      "Run the documented build sequence locally before deploying.",
      "Store secret values in Vercel environment settings, not source files.",
      "Verify that generated documentation is present in public/docs before the Next.js build."
    ],
    "anti_patterns": [
      "Do not commit API keys or authentication secrets to the repository.",
      "Do not skip the documentation build before copying its output.",
      "Do not assume backend route rewrites work without checking the Vercel configuration."
    ],
    "faq": [
      {
        "question": "Does this skill deploy the application?",
        "answer": "No. It documents the deployment pipeline and configuration requirements."
      },
      {
        "question": "Which applications does the build process include?",
        "answer": "The documented process includes a Next.js root application and a Docusaurus documentation application."
      },
      {
        "question": "Where is the documentation output placed?",
        "answer": "The documented process copies generated files into public/docs."
      },
      {
        "question": "Where are environment variables configured?",
        "answer": "Configure them in the Vercel Dashboard for the deployment environment."
      },
      {
        "question": "Does the skill reveal secret values?",
        "answer": "No. It lists variable names only and does not access their values."
      },
      {
        "question": "How are API requests handled?",
        "answer": "The documented Vercel configuration rewrites /api requests to the Python function."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 29
    }
  ]
}
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall