Agent Skills
› nixopus/nixopus
› static-deploy
static-deploy
GitHub用于部署无服务端运行时静态网站（如HTML、SPA）的Skill。通过检测index.html或Staticfile识别项目，支持配置Caddy/Nginx及Dockerfile模式，适用于构建输出目录或纯HTML文件的托管场景。
Trigger Scenarios
检测到项目根目录存在 index.html
检测到项目根目录存在 Staticfile
用户请求部署静态 HTML 站点
Install
npx skills add nixopus/nixopus --skill static-deploy -g -y
SKILL.md
Frontmatter
{
"name": "static-deploy",
"metadata": {
"version": "1.0"
},
"description": "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."
}
Static Files Deployment
Detection
Project is static if:
index.htmlexists in the root- Or
Staticfileexists at the project root (explicit configuration)
Configuration
Root Directory
Staticfilecontents:root: <dir>- 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
| Layout | Root to serve |
|---|---|
| Built SPA (Vite, etc.) | dist |
| Jekyll / Hugo output | _site or public |
| Plain HTML | . (current dir) |
| Nested | Configure 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"]
Version History
- cf05d97 Current 2026-08-20 14:52
