gh-pages-deploy — Claude Code skill: deploy and install
This skill publishes HTML/CSS/JS projects to GitHub Pages with gh. Use it when a project needs a public URL.
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a claude-codeWhat gh-pages-deploy does
The skill takes a local frontend project through Git setup, repository creation, Pages configuration, and deployment checks. It can publish from the root of main or from docs, then puts the Pages address into the repository’s About section.
It requires GitHub CLI gh to be installed and authenticated, plus Git and a ready HTML, CSS, or JavaScript project. Deployment stops without an authenticated gh session. Later changes follow the usual commit-and-push flow; GitHub Pages rebuilds the site after pushes to main. Keep index.html in the selected publishing location.
What it helps with
- publish an HTML/CSS/JS project on GitHub Pages
- create a public repository with
gh - configure Pages for
mainand the project root - check the latest Pages build
- push site updates for another rebuild
Example prompts for the agent
- Publish this project to GitHub Pages and create the repository
my-site. - Configure Pages to use the
docsdirectory, then check the deployment status. - Commit the current changes and push them to
mainso the site rebuilds.
How to install gh-pages-deploy
1Skills CLI (Vercel)
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a claude-code2Manually: put the files in place
~/.claude/skills/gh-pages-deploy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gh-pages-deploy/
1Skills CLI (Vercel)
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a codex2Manually: put the files in place
.agents/skills/gh-pages-deploy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a cursor2Manually: put the files in place
.cursor/skills/gh-pages-deploy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aviz85/claude-skills-library gh-pages-deploy2Manually: put the files in place
.github/skills/gh-pages-deploy/SKILL.md1Skills CLI (Vercel)
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a gemini-cli2Platform CLI
gemini skills install https://github.com/aviz85/claude-skills-library --path skills/gh-pages-deployManually: put the files in place
.devin/skills/gh-pages-deploy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gh-pages-deploy
How do I install gh-pages-deploy in Claude Code?
Run npx skills add aviz85/claude-skills-library --skill gh-pages-deploy -a claude-code, then check ~/.claude/skills/gh-pages-deploy/SKILL.md.
What does gh-pages-deploy do?
It prepares Git, creates a public repository with gh, enables GitHub Pages, checks the deployment, and sets the repository homepage URL.
What does the skill require?
You need an authenticated GitHub CLI gh, Git, and a ready HTML, CSS, or JavaScript project. A public repository is required for free GitHub Pages.