{
  "schemaVersion": "1.0",
  "item": {
    "slug": "nginx-config-creator",
    "name": "Nginx Config Creator",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/xieyuanqing/nginx-config-creator",
    "canonicalUrl": "https://clawhub.ai/xieyuanqing/nginx-config-creator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/nginx-config-creator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nginx-config-creator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/create-and-reload.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/nginx-config-creator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/nginx-config-creator",
    "agentPageUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Nginx Config Creator (Enterprise Grade)",
        "body": "This skill automates the creation of Nginx/OpenResty reverse proxy configurations. It is designed for both ease of use and safety, incorporating environment awareness and a critical safety-check mechanism."
      },
      {
        "title": "Features",
        "body": "Environment Awareness: Simplifies commands by reading configuration from environment variables.\nSafety Check: Includes a '熔断' (fuse) mechanism. It tests the configuration before applying it and automatically rolls back if the test fails, preventing web server downtime."
      },
      {
        "title": "Pre-requisites (Recommended)",
        "body": "For maximum convenience, it is recommended to set the following environment variables on the host system:\n\nNGINX_CONFIG_PATH: The absolute path to the Nginx conf.d directory.\nNGINX_CONTAINER_NAME: The name of the running Nginx/OpenResty Docker container.\n\nIf these are not set, they must be provided as command-line arguments."
      },
      {
        "title": "Core Action: scripts/create-and-reload.sh",
        "body": "This script performs the entire operation."
      },
      {
        "title": "Inputs (Command-Line Arguments)",
        "body": "--service-name: (Required) The short name for the service (e.g., grafana).\n--domain: (Required) The root domain name (e.g., example.com).\n--port: (Required) The local port the service is running on (e.g., 3000).\n--config-path: (Optional) The path to Nginx's conf.d directory. Overrides the NGINX_CONFIG_PATH environment variable.\n--container-name: (Optional) The name of the Nginx Docker container. Overrides the NGINX_CONTAINER_NAME environment variable."
      },
      {
        "title": "Output",
        "body": "On Success: Prints a step-by-step log of its actions and a final success message.\nOn Failure: Prints a descriptive error message to stderr and exits. If the failure occurs during the Nginx configuration test, the full error from nginx -t is displayed."
      },
      {
        "title": "Execution Workflow",
        "body": "Parse Arguments & Environment: The script gathers all necessary paths and names from command-line arguments and environment variables.\nGenerate Config: It creates the .conf file in the target directory.\nTest Config (Safety Check): It executes nginx -t inside the specified container.\nDecide & Act:\n\nIf the test passes, it proceeds to reload Nginx via nginx -s reload.\nIf the test fails, it automatically deletes the generated file (rolls back) and reports the error.\n\n\nReport Result: Informs the user of the final outcome."
      },
      {
        "title": "Example Usage",
        "body": "Scenario 1: Environment variables are pre-set\n\n# Set for future convenience\nexport NGINX_CONFIG_PATH=\"/path/to/your/nginx/conf.d\"\nexport NGINX_CONTAINER_NAME=\"your_nginx_container\"\n\n# Now, the command is very simple:\nbash skills/nginx-config-creator/scripts/create-and-reload.sh \\\n  --service-name \"grafana\" \\\n  --domain \"example.com\" \\\n  --port \"3000\"\n\nScenario 2: No environment variables (providing all info via arguments)\n\nbash skills/nginx-config-creator/scripts/create-and-reload.sh \\\n  --service-name \"grafana\" \\\n  --domain \"example.com\" \\\n  --port \"3000\" \\\n  --config-path \"/path/to/your/nginx/conf.d\" \\\n  --container-name \"your_nginx_container\""
      },
      {
        "title": "Failure Strategy",
        "body": "Missing Arguments: The script will exit with an error if required arguments/environment variables are missing.\nnginx -t Fails: The skill is designed to be safe. It will not attempt to reload a broken configuration. It will clean up after itself and show you the exact error, ensuring the live web server is never affected."
      }
    ],
    "body": "Nginx Config Creator (Enterprise Grade)\n\nThis skill automates the creation of Nginx/OpenResty reverse proxy configurations. It is designed for both ease of use and safety, incorporating environment awareness and a critical safety-check mechanism.\n\nFeatures\nEnvironment Awareness: Simplifies commands by reading configuration from environment variables.\nSafety Check: Includes a '熔断' (fuse) mechanism. It tests the configuration before applying it and automatically rolls back if the test fails, preventing web server downtime.\nPre-requisites (Recommended)\n\nFor maximum convenience, it is recommended to set the following environment variables on the host system:\n\nNGINX_CONFIG_PATH: The absolute path to the Nginx conf.d directory.\nNGINX_CONTAINER_NAME: The name of the running Nginx/OpenResty Docker container.\n\nIf these are not set, they must be provided as command-line arguments.\n\nCore Action: scripts/create-and-reload.sh\n\nThis script performs the entire operation.\n\nInputs (Command-Line Arguments)\n--service-name: (Required) The short name for the service (e.g., grafana).\n--domain: (Required) The root domain name (e.g., example.com).\n--port: (Required) The local port the service is running on (e.g., 3000).\n--config-path: (Optional) The path to Nginx's conf.d directory. Overrides the NGINX_CONFIG_PATH environment variable.\n--container-name: (Optional) The name of the Nginx Docker container. Overrides the NGINX_CONTAINER_NAME environment variable.\nOutput\nOn Success: Prints a step-by-step log of its actions and a final success message.\nOn Failure: Prints a descriptive error message to stderr and exits. If the failure occurs during the Nginx configuration test, the full error from nginx -t is displayed.\nExecution Workflow\nParse Arguments & Environment: The script gathers all necessary paths and names from command-line arguments and environment variables.\nGenerate Config: It creates the .conf file in the target directory.\nTest Config (Safety Check): It executes nginx -t inside the specified container.\nDecide & Act:\nIf the test passes, it proceeds to reload Nginx via nginx -s reload.\nIf the test fails, it automatically deletes the generated file (rolls back) and reports the error.\nReport Result: Informs the user of the final outcome.\nExample Usage\n\nScenario 1: Environment variables are pre-set\n\n# Set for future convenience\nexport NGINX_CONFIG_PATH=\"/path/to/your/nginx/conf.d\"\nexport NGINX_CONTAINER_NAME=\"your_nginx_container\"\n\n# Now, the command is very simple:\nbash skills/nginx-config-creator/scripts/create-and-reload.sh \\\n  --service-name \"grafana\" \\\n  --domain \"example.com\" \\\n  --port \"3000\"\n\n\nScenario 2: No environment variables (providing all info via arguments)\n\nbash skills/nginx-config-creator/scripts/create-and-reload.sh \\\n  --service-name \"grafana\" \\\n  --domain \"example.com\" \\\n  --port \"3000\" \\\n  --config-path \"/path/to/your/nginx/conf.d\" \\\n  --container-name \"your_nginx_container\"\n\nFailure Strategy\nMissing Arguments: The script will exit with an error if required arguments/environment variables are missing.\nnginx -t Fails: The skill is designed to be safe. It will not attempt to reload a broken configuration. It will clean up after itself and show you the exact error, ensuring the live web server is never affected."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/xieyuanqing/nginx-config-creator",
    "publisherUrl": "https://clawhub.ai/xieyuanqing/nginx-config-creator",
    "owner": "xieyuanqing",
    "version": "0.1.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/nginx-config-creator",
    "downloadUrl": "https://openagent3.xyz/downloads/nginx-config-creator",
    "agentUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nginx-config-creator/agent.md"
  }
}