OpenParable
Skip to content
← Back to skills

Static Deploy

DevOps & Security
static-deploy

Static Deploy is an Agent Skill for devops & security published in the nixopus/nixopus repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Deploy static file sites — Caddy/nginx serving, Staticfile config, and Dockerfile patterns. Use when deploying a static HTML site with no server-side runtime, or when index.html or a Staticfile is detected at the project root.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/nixopus/nixopus/blob/HEAD/api/skills/static-deploy/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/static-deploy, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Static Files Deployment

Detection

Project is static if:

  1. index.html exists in the root
  2. Or Staticfile exists at the project root (explicit configuration)

Configuration

Root Directory

  1. Staticfile contents: root: <dir>
  2. Default: current directory (.)

Staticfile

Create a Staticfile at the project root:

root: dist

Custom Caddyfile

Place a Caddyfile at the project root to override the default Caddy configuration.

Typical Layouts

LayoutRoot to serve
Built SPA (Vite, etc.)dist
Jekyll / Hugo output_site or public
Plain HTML. (current dir)
NestedConfigure via Staticfile

Dockerfile Patterns

Nginx

FROM nginx:alpine
COPY . /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Caddy

FROM caddy:alpine
COPY . /srv
EXPOSE 80
CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile"]

With custom Caddyfile

FROM caddy:alpine
COPY Caddyfile /etc/caddy/Caddyfile
COPY dist /srv
EXPOSE 80
CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile"]