Skip to content

secondsky/claude-skills / plugins/hugo/skills/hugo

Hugo static site generator with Tailwind v4, headless CMS (Sveltia/Tina), Cloudflare deployment. Use for blogs, docs sites, or encountering theme installation, frontmatter, baseURL errors.

FileKindSize
SKILL.mdskill md15.7 KB
references/advanced-topics.mdmarkdown11.5 KB
references/cms-integration.mdmarkdown10.5 KB
references/common-patterns.mdmarkdown10.5 KB
references/error-catalog.mdmarkdown11.6 KB
references/setup-guide.mdmarkdown11.0 KB
references/tailwind-integration.mdmarkdown12.4 KB
templates/hugo-blog/.github/workflows/deploy.ymlconfig621 B
templates/hugo-blog/.gitmodulesother112 B
templates/hugo-blog/.hugo_build.lockother0 B
templates/hugo-blog/README.mdmarkdown4.0 KB
templates/hugo-blog/archetypes/default.mdmarkdown101 B
templates/hugo-blog/content/posts/first-post.mdmarkdown504 B
templates/hugo-blog/hugo.yamlconfig643 B
templates/hugo-blog/static/admin/config.ymlconfig1.2 KB
templates/hugo-blog/static/admin/index.htmlother310 B
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/bug.yamlconfig3.9 KB
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/config.ymlconfig234 B
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/enhancement.yamlconfig1.5 KB
templates/hugo-blog/themes/PaperMod/.github/PULL_REQUEST_TEMPLATE.mdmarkdown1.7 KB
templates/hugo-blog/themes/PaperMod/.github/workflows/gh-pages.ymlconfig1.9 KB
templates/hugo-blog/themes/PaperMod/LICENSEother1.1 KB
templates/hugo-blog/themes/PaperMod/README.mdmarkdown4.7 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/404.cssother200 B
templates/hugo-blog/themes/PaperMod/assets/css/common/archive.cssother651 B
templates/hugo-blog/themes/PaperMod/assets/css/common/footer.cssother1.0 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/header.cssother1.3 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/main.cssother1.0 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/post-entry.cssother1.7 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/post-single.cssother6.4 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/profile-mode.cssother689 B
templates/hugo-blog/themes/PaperMod/assets/css/common/search.cssother782 B
templates/hugo-blog/themes/PaperMod/assets/css/common/terms.cssother324 B
templates/hugo-blog/themes/PaperMod/assets/css/core/license.cssother193 B
templates/hugo-blog/themes/PaperMod/assets/css/core/reset.cssother1.3 KB
templates/hugo-blog/themes/PaperMod/assets/css/core/theme-vars.cssother969 B
templates/hugo-blog/themes/PaperMod/assets/css/core/zmedia.cssother1023 B
templates/hugo-blog/themes/PaperMod/assets/css/extended/blank.cssother239 B
templates/hugo-blog/themes/PaperMod/assets/css/includes/chroma-mod.cssother303 B
templates/hugo-blog/themes/PaperMod/assets/css/includes/chroma-styles.cssother4.9 KB
templates/hugo-blog/themes/PaperMod/assets/css/includes/scroll-bar.cssother1.2 KB
templates/hugo-blog/themes/PaperMod/assets/js/fastsearch.jsscript5.6 KB
templates/hugo-blog/themes/PaperMod/assets/js/fuse.basic.min.jsscript15.0 KB
templates/hugo-blog/themes/PaperMod/assets/js/license.jsscript193 B
templates/hugo-blog/themes/PaperMod/go.modmanifest55 B
templates/hugo-blog/themes/PaperMod/i18n/ar.yamlconfig546 B
templates/hugo-blog/themes/PaperMod/i18n/be.yamlconfig805 B
templates/hugo-blog/themes/PaperMod/i18n/bg.yamlconfig322 B
templates/hugo-blog/themes/PaperMod/i18n/bn.yamlconfig695 B
templates/hugo-blog/themes/PaperMod/i18n/ca.yamlconfig313 B
templates/hugo-blog/themes/PaperMod/i18n/ckb.yamlconfig473 B
templates/hugo-blog/themes/PaperMod/i18n/cs.yamlconfig498 B
templates/hugo-blog/themes/PaperMod/i18n/da.yamlconfig435 B
templates/hugo-blog/themes/PaperMod/i18n/de.yamlconfig517 B
templates/hugo-blog/themes/PaperMod/i18n/el.yamlconfig624 B
templates/hugo-blog/themes/PaperMod/i18n/en.yamlconfig486 B
templates/hugo-blog/themes/PaperMod/i18n/eo.yamlconfig378 B
templates/hugo-blog/themes/PaperMod/i18n/es.yamlconfig512 B
templates/hugo-blog/themes/PaperMod/i18n/fa.yamlconfig474 B
templates/hugo-blog/themes/PaperMod/i18n/fi.yamlconfig512 B
templates/hugo-blog/themes/PaperMod/i18n/fr.yamlconfig505 B
templates/hugo-blog/themes/PaperMod/i18n/he.yamlconfig543 B
templates/hugo-blog/themes/PaperMod/i18n/hi.yamlconfig367 B
templates/hugo-blog/themes/PaperMod/i18n/hr.yamlconfig543 B
templates/hugo-blog/themes/PaperMod/i18n/hu.yamlconfig275 B
templates/hugo-blog/themes/PaperMod/i18n/id.yamlconfig500 B
templates/hugo-blog/themes/PaperMod/i18n/it.yamlconfig509 B
templates/hugo-blog/themes/PaperMod/i18n/ja.yamlconfig505 B
templates/hugo-blog/themes/PaperMod/i18n/ko.yamlconfig506 B
templates/hugo-blog/themes/PaperMod/i18n/ku.yamlconfig391 B
templates/hugo-blog/themes/PaperMod/i18n/mn.yamlconfig411 B
templates/hugo-blog/themes/PaperMod/i18n/ms.yamlconfig439 B
templates/hugo-blog/themes/PaperMod/i18n/nl.yamlconfig509 B
templates/hugo-blog/themes/PaperMod/i18n/no.yamlconfig504 B
templates/hugo-blog/themes/PaperMod/i18n/oc.yamlconfig497 B
templates/hugo-blog/themes/PaperMod/i18n/pa.yamlconfig582 B
templates/hugo-blog/themes/PaperMod/i18n/pl.yamlconfig517 B
templates/hugo-blog/themes/PaperMod/i18n/pnb.yamlconfig533 B
templates/hugo-blog/themes/PaperMod/i18n/pt.yamlconfig523 B
templates/hugo-blog/themes/PaperMod/i18n/ro.yamlconfig499 B
templates/hugo-blog/themes/PaperMod/i18n/ru.yamlconfig805 B
templates/hugo-blog/themes/PaperMod/i18n/sk.yamlconfig496 B
templates/hugo-blog/themes/PaperMod/i18n/sv.yamlconfig440 B
templates/hugo-blog/themes/PaperMod/i18n/sw.yamlconfig502 B
templates/hugo-blog/themes/PaperMod/i18n/th.yamlconfig614 B
templates/hugo-blog/themes/PaperMod/i18n/tr.yamlconfig508 B
templates/hugo-blog/themes/PaperMod/i18n/uk.yamlconfig454 B
templates/hugo-blog/themes/PaperMod/i18n/uz.yamlconfig335 B
templates/hugo-blog/themes/PaperMod/i18n/vi.yamlconfig533 B
templates/hugo-blog/themes/PaperMod/i18n/zh-tw.yamlconfig525 B
templates/hugo-blog/themes/PaperMod/i18n/zh.yamlconfig493 B
templates/hugo-blog/themes/PaperMod/images/screenshot.pngbinary138.2 KB
templates/hugo-blog/themes/PaperMod/images/tn.pngbinary15.5 KB
templates/hugo-blog/themes/PaperMod/layouts/404.htmlother85 B
templates/hugo-blog/themes/PaperMod/layouts/_default/_markup/render-image.htmlother730 B
templates/hugo-blog/themes/PaperMod/layouts/_default/archives.htmlother2.7 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/baseof.htmlother1.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/index.jsonconfig341 B
templates/hugo-blog/themes/PaperMod/layouts/_default/list.htmlother4.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/rss.xmlconfig3.4 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/search.htmlother1.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/single.htmlother2.2 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/terms.htmlother643 B
templates/hugo-blog/themes/PaperMod/layouts/partials/anchored_headings.htmlother212 B
templates/hugo-blog/themes/PaperMod/layouts/partials/author.htmlother316 B
templates/hugo-blog/themes/PaperMod/layouts/partials/breadcrumbs.htmlother692 B
templates/hugo-blog/themes/PaperMod/layouts/partials/comments.htmlother151 B
templates/hugo-blog/themes/PaperMod/layouts/partials/cover.htmlother3.0 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/edit_post.htmlother692 B
templates/hugo-blog/themes/PaperMod/layouts/partials/extend_footer.htmlother169 B
templates/hugo-blog/themes/PaperMod/layouts/partials/extend_head.htmlother313 B
templates/hugo-blog/themes/PaperMod/layouts/partials/footer.htmlother5.1 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/head.htmlother8.7 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/header.htmlother6.1 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/home_info.htmlother425 B
templates/hugo-blog/themes/PaperMod/layouts/partials/index_profile.htmlother2.8 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/post_canonical.htmlother599 B
templates/hugo-blog/themes/PaperMod/layouts/partials/post_meta.htmlother836 B
templates/hugo-blog/themes/PaperMod/layouts/partials/post_nav_links.htmlother543 B
templates/hugo-blog/themes/PaperMod/layouts/partials/share_icons.htmlother9.9 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/social_icons.htmlother320 B
templates/hugo-blog/themes/PaperMod/layouts/partials/svg.htmlother177.0 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/_funcs/get-page-images.htmlother1.4 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/opengraph.htmlother2.6 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/schema_json.htmlother3.9 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/twitter_cards.htmlother1.2 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/toc.htmlother4.3 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/translation_list.htmlother627 B
templates/hugo-blog/themes/PaperMod/layouts/robots.txtmarkdown164 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/collapse.htmlother298 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/figure.htmlother1.4 KB
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/inTextImg.htmlother181 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/ltr.htmlother286 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/rawhtml.htmlother32 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/rtl.htmlother286 B
templates/hugo-blog/themes/PaperMod/theme.tomlconfig1.1 KB
templates/hugo-blog/wrangler.jsoncother198 B
templates/hugo-docs/README.mdmarkdown8.5 KB
templates/hugo-docs/archetypes/default.mdmarkdown104 B
templates/hugo-docs/content/_index.mdmarkdown568 B
templates/hugo-docs/content/docs/_index.mdmarkdown164 B
templates/hugo-docs/content/docs/advanced/_index.mdmarkdown136 B
templates/hugo-docs/content/docs/advanced/customization.mdmarkdown2.3 KB
templates/hugo-docs/content/docs/configuration.mdmarkdown1.5 KB
templates/hugo-docs/content/docs/getting-started.mdmarkdown1.2 KB
templates/hugo-docs/hugo.yamlconfig1.3 KB
templates/hugo-docs/resources/_gen/assets/book.scss_b807c86e8030af4cdc30edccea379f5f.contentother17.0 KB
templates/hugo-docs/resources/_gen/assets/book.scss_b807c86e8030af4cdc30edccea379f5f.jsonconfig188 B
templates/hugo-docs/themes/hugo-book/.github/workflows/deploy.ymlconfig987 B
templates/hugo-docs/themes/hugo-book/.github/workflows/main.ymlconfig640 B
templates/hugo-docs/themes/hugo-book/.gitignoreother66 B
templates/hugo-docs/themes/hugo-book/LICENSEother1.1 KB
templates/hugo-docs/themes/hugo-book/README.mdmarkdown12.9 KB
templates/hugo-docs/themes/hugo-book/archetypes/docs.mdmarkdown227 B
templates/hugo-docs/themes/hugo-book/archetypes/posts.mdmarkdown148 B
templates/hugo-docs/themes/hugo-book/assets/_custom.scssother310 B
templates/hugo-docs/themes/hugo-book/assets/_defaults.scssother2.2 KB
templates/hugo-docs/themes/hugo-book/assets/_fonts.scssother130 B
templates/hugo-docs/themes/hugo-book/assets/_main.scssother6.3 KB
templates/hugo-docs/themes/hugo-book/assets/_markdown.scssother3.9 KB
templates/hugo-docs/themes/hugo-book/assets/_print.scssother260 B
templates/hugo-docs/themes/hugo-book/assets/_shortcodes.scssother5.1 KB
templates/hugo-docs/themes/hugo-book/assets/_utils.scssother1.0 KB
templates/hugo-docs/themes/hugo-book/assets/_variables.scssother44 B
templates/hugo-docs/themes/hugo-book/assets/book.scssother370 B
templates/hugo-docs/themes/hugo-book/assets/clipboard.jsscript396 B
templates/hugo-docs/themes/hugo-book/assets/icons/backward.svgother347 B
templates/hugo-docs/themes/hugo-book/assets/icons/calendar.svgother411 B
templates/hugo-docs/themes/hugo-book/assets/icons/chevron-right.svgother178 B
templates/hugo-docs/themes/hugo-book/assets/icons/edit.svgother659 B
templates/hugo-docs/themes/hugo-book/assets/icons/forward.svgother349 B
templates/hugo-docs/themes/hugo-book/assets/icons/menu.svgother451 B
templates/hugo-docs/themes/hugo-book/assets/icons/toc.svgother753 B
templates/hugo-docs/themes/hugo-book/assets/icons/translate.svgother650 B
templates/hugo-docs/themes/hugo-book/assets/katex.jsonconfig185 B
templates/hugo-docs/themes/hugo-book/assets/manifest.jsonconfig333 B
templates/hugo-docs/themes/hugo-book/assets/menu-reset.jsscript265 B
templates/hugo-docs/themes/hugo-book/assets/mermaid.jsonconfig70 B
templates/hugo-docs/themes/hugo-book/assets/normalize.cssother3.3 KB
templates/hugo-docs/themes/hugo-book/assets/plugins/_numbered.scssother618 B
templates/hugo-docs/themes/hugo-book/assets/plugins/_scrollbars.scssother394 B
templates/hugo-docs/themes/hugo-book/assets/search-data.jsonconfig706 B
templates/hugo-docs/themes/hugo-book/assets/search.jsscript2.7 KB
templates/hugo-docs/themes/hugo-book/assets/sw-register.jsscript223 B
templates/hugo-docs/themes/hugo-book/assets/sw.jsscript1.3 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/_custom.scssother103 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/_variables.scssother44 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/asciinema-627097.castother60.5 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/book-starter.castother33.8 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/placeholder.svgother585 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/thumbnail.svgother585 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/_index.mdmarkdown2.2 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/_index.mdmarkdown2.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/3rd-level/4th-level.mdmarkdown551 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/3rd-level/_index.mdmarkdown1.4 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/_index.mdmarkdown45 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/hidden.mdmarkdown1.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/_index.mdmarkdown3.5 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/with-toc.mdmarkdown2.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/without-toc.mdmarkdown2.4 KB

templates/hugo-blog/README.md

View on GitHub
# Hugo Blog Template (PaperMod Theme)

**Purpose**: Production-ready blog template with PaperMod theme, Sveltia CMS, and Cloudflare Workers deployment.

**Features**:
- ✅ PaperMod theme (dark/light/auto mode)
- ✅ Search functionality
- ✅ Tags and categories
- ✅ Reading time, share buttons, code copy
- ✅ Sveltia CMS pre-configured
- ✅ Cloudflare Workers Static Assets ready
- ✅ GitHub Actions workflow included

---

## Quick Start

### 1. Copy Template
```bash
cp -r skills/hugo/templates/hugo-blog/ my-blog/
cd my-blog/
```

### 2. Initialize Git and Theme
```bash
git init
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
```

### 3. Customize Configuration
Edit `hugo.yaml`:
- Change `baseURL` to your domain
- Update `title`, `description`, `author`
- Update social links
- Customize menu items

### 4. Create Content
```bash
# Create blog posts
hugo new content posts/my-first-post.md

# Edit the post, set draft: false
```

### 5. Test Locally
```bash
hugo server
# Visit: http://localhost:1313
```

### 6. Deploy to Cloudflare Workers
```bash
# Build
hugo --minify

# Deploy
npx wrangler deploy
```

---

## What's Included

### Configuration Files
- `hugo.yaml` - Complete PaperMod configuration
- `wrangler.jsonc` - Cloudflare Workers config
- `.gitignore` - Ignores public/, resources/, etc.
- `.gitmodules` - PaperMod theme reference (you'll create this)

### Sveltia CMS
- `static/admin/index.html` - CMS interface
- `static/admin/config.yml` - CMS configuration
- Pre-configured for blog posts and pages
- Local backend enabled for testing

### Sample Content
- `content/posts/first-post.md` - Example blog post
- Ready to customize and expand

### GitHub Actions
- `.github/workflows/deploy.yml` - Auto-deployment on push
- Builds with Hugo Extended
- Deploys to Cloudflare Workers
- Requires: `CLOUDFLARE_API_TOKEN` secret

---

## Customization

### Theme Settings
All theme customization in `hugo.yaml` under `params`:
- Colors, fonts, layout
- Enable/disable features
- Social icons
- Menu configuration

### Adding Pages
```bash
hugo new content about.md
hugo new content contact.md
```

### Adding to Menu
```yaml
# hugo.yaml
menu:
  main:
    - identifier: about
      name: About
      url: /about/
      weight: 60
```

### Sveltia CMS Backend
For production, you'll need OAuth setup:
1. See `references/sveltia-integration-guide.md`
2. Or use Cloudflare Workers OAuth proxy
3. Or use Git Gateway with Netlify Identity

---

## Important Notes

- **Theme Submodule**: Always clone with `git clone --recursive` or run `git submodule update --init --recursive`
- **Hugo Extended**: Required for SCSS support
- **baseURL**: Must match deployment URL for assets to work
- **Draft Posts**: Set `draft: false` to publish
- **Future Dates**: Posts won't appear until date passes (unless `--buildFuture`)

---

## File Structure

```
hugo-blog/
├── hugo.yaml              # Main configuration
├── wrangler.jsonc         # Workers deployment config
├── .gitignore             # Git ignore patterns
├── content/               # All content here
│   └── posts/
│       └── first-post.md
├── static/                # Static assets
│   └── admin/             # Sveltia CMS
│       ├── index.html
│       └── config.yml
├── themes/                # Themes (you'll add PaperMod)
│   └── PaperMod/          # Git submodule
└── .github/
    └── workflows/
        └── deploy.yml     # GitHub Actions
```

---

## Next Steps

1. ✅ Copy template
2. ✅ Initialize Git + add theme submodule
3. ✅ Customize hugo.yaml
4. ✅ Create first post
5. ✅ Test locally with `hugo server`
6. ✅ Build with `hugo --minify`
7. ✅ Deploy with `npx wrangler deploy`
8. ✅ Set up GitHub Actions (add CLOUDFLARE_API_TOKEN secret)
9. ✅ Configure Sveltia CMS OAuth (for production)
10. ✅ Start blogging!

---

**Production Ready**: This template is tested and deployed at https://hugo-blog-test.webfonts.workers.dev
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 323kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall