# Gh Actions Static Deploy

> Automating the build and deployment of static sites on every push.

- Skill: `jcorpac/gh-actions-static-deploy` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jcorpac/gh-actions-static-deploy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jcorpac/gh-actions-static-deploy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: jcorpac (https://skillmd.com/u/jcorpac)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jcorpac/gh-actions-static-deploy

---


# GitHub Actions Static Deploy

Ensure your showcase is always in sync with your source code.

## Workflow Configuration
- **Triggers**: Trigger on every `push` to the `master` or `main` branch.
- **Permissions**: Grant `contents: write` or use the dedicated `pages` deployment token.

## Essential Steps
1.  **Checkout**: Use `actions/checkout`.
2.  **Build**: (Optional) Run minification or bundling scripts.
3.  **Deploy**: Use the `peaceiris/actions-gh-pages` action to push the static folder to the `gh-pages` branch.

## Best Practices
- **Custom Domain CNAME**: Ensure your `CNAME` file is included in the build/deployment folder to prevent domain resets.
- **Build Notifications**: Notify a Slack or Discord channel on successful or failed deployments.