# Send Nginx Config Creator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/nginx-config-creator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nginx-config-creator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/create-and-reload.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "nginx-config-creator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T04:30:07.154Z",
      "expiresAt": "2026-05-13T04:30:07.154Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nginx-config-creator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nginx-config-creator",
        "contentDisposition": "attachment; filename=\"nginx-config-creator-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "nginx-config-creator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Nginx Config Creator (Enterprise Grade)

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.

### Features

Environment Awareness: Simplifies commands by reading configuration from environment variables.
Safety Check: Includes a '熔断' (fuse) mechanism. It tests the configuration before applying it and automatically rolls back if the test fails, preventing web server downtime.

### Pre-requisites (Recommended)

For maximum convenience, it is recommended to set the following environment variables on the host system:

NGINX_CONFIG_PATH: The absolute path to the Nginx conf.d directory.
NGINX_CONTAINER_NAME: The name of the running Nginx/OpenResty Docker container.

If these are not set, they must be provided as command-line arguments.

### Core Action: scripts/create-and-reload.sh

This script performs the entire operation.

### Inputs (Command-Line Arguments)

--service-name: (Required) The short name for the service (e.g., grafana).
--domain: (Required) The root domain name (e.g., example.com).
--port: (Required) The local port the service is running on (e.g., 3000).
--config-path: (Optional) The path to Nginx's conf.d directory. Overrides the NGINX_CONFIG_PATH environment variable.
--container-name: (Optional) The name of the Nginx Docker container. Overrides the NGINX_CONTAINER_NAME environment variable.

### Output

On Success: Prints a step-by-step log of its actions and a final success message.
On 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.

### Execution Workflow

Parse Arguments & Environment: The script gathers all necessary paths and names from command-line arguments and environment variables.
Generate Config: It creates the .conf file in the target directory.
Test Config (Safety Check): It executes nginx -t inside the specified container.
Decide & Act:

If the test passes, it proceeds to reload Nginx via nginx -s reload.
If the test fails, it automatically deletes the generated file (rolls back) and reports the error.


Report Result: Informs the user of the final outcome.

### Example Usage

Scenario 1: Environment variables are pre-set

# Set for future convenience
export NGINX_CONFIG_PATH="/path/to/your/nginx/conf.d"
export NGINX_CONTAINER_NAME="your_nginx_container"

# Now, the command is very simple:
bash skills/nginx-config-creator/scripts/create-and-reload.sh \\
  --service-name "grafana" \\
  --domain "example.com" \\
  --port "3000"

Scenario 2: No environment variables (providing all info via arguments)

bash skills/nginx-config-creator/scripts/create-and-reload.sh \\
  --service-name "grafana" \\
  --domain "example.com" \\
  --port "3000" \\
  --config-path "/path/to/your/nginx/conf.d" \\
  --container-name "your_nginx_container"

### Failure Strategy

Missing Arguments: The script will exit with an error if required arguments/environment variables are missing.
nginx -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
- Source: tencent
- Verification: Indexed source record
- Publisher: xieyuanqing
- Version: 0.1.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T04:30:07.154Z
- Expires at: 2026-05-13T04:30:07.154Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/nginx-config-creator)
- [Send to Agent page](https://openagent3.xyz/skills/nginx-config-creator/agent)
- [JSON manifest](https://openagent3.xyz/skills/nginx-config-creator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/nginx-config-creator/agent.md)
- [Download page](https://openagent3.xyz/downloads/nginx-config-creator)