# Skill 133

> Commit and publish Quarto project to GitHub Pages. Use when the user wants to publish changes to a Quarto book or website.

- Skill: `legendtkl/skill-133` (Agent Skill)
- Install (CLI): `npx skillmds@latest add legendtkl/skill-133`
- Raw SKILL.md: https://api.skillmd.com/api/skills/legendtkl/skill-133/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: legendtkl (https://skillmd.com/u/legendtkl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/legendtkl/skill-133

---


# Publish Quarto Project

When the user invokes `/publish`, commit and publish the Quarto project to GitHub Pages.

## Steps

### 1. Check for Changes

```bash
git status
```

If no changes, inform the user and stop.

### 2. Show What Will Be Committed

List the changed files and ask the user for a commit message, or suggest one based on recent work.

### 3. Commit and Push

```bash
git add .
git commit -m "USER_MESSAGE

Co-Authored-By: Claude <noreply@anthropic.com>"
git push
```

### 4. Publish to GitHub Pages

```bash
quarto publish gh-pages --no-prompt
```

If quarto is not in PATH, try `/usr/local/bin/quarto`.

### 5. Confirm

Tell the user:
- Commit was created
- Site will be live in 1-3 minutes at the GitHub Pages URL
- Provide the URL if known (check `_quarto.yml` or git remote)

## Notes

- This skill assumes the project is already set up for GitHub Pages (has `gh-pages` branch)
- If `quarto publish` fails, show the error and suggest troubleshooting steps
- The GitHub Pages URL follows the pattern: `https://ORG.github.io/REPO/`