secondsky/claude-skills / plugins/nuxt-content/skills/nuxt-content
nuxt-content
VerifiedNuxt Content v3 Git-based CMS for Markdown/MDC content sites. Use for blogs, docs, content-driven apps with type-safe queries, schema validation (Zod/Valibot), full-text search, navigation utilities. Supports Nuxt Studio production editing, Cloudflare D1/Pages deployment, Vercel deployment, SQL storage, MDC components, content collections.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.7 KB |
| assets/blog-collection.example.ts | script | 3.7 KB |
| assets/content.config.example.ts | script | 1.8 KB |
| assets/docs-collection.example.ts | script | 5.9 KB |
| assets/nuxt.config.example.ts | script | 1.9 KB |
| references/collection-examples.md | markdown | 6.6 KB |
| references/deployment-checklists.md | markdown | 4.8 KB |
| references/error-catalog.md | markdown | 9.9 KB |
| references/mdc-syntax-reference.md | markdown | 2.0 KB |
| references/query-operators.md | markdown | 2.9 KB |
| references/studio-setup-guide.md | markdown | 4.1 KB |
| scripts/deploy-cloudflare.shexecutable | script | 2.7 KB |
| scripts/deploy-vercel.shexecutable | script | 1.9 KB |
| scripts/setup-nuxt-content.shexecutable | script | 5.2 KB |
| scripts/setup-studio.shexecutable | script | 3.8 KB |
| templates/blog-collection-setup.ts | script | 7.1 KB |
references/deployment-checklists.md
View on GitHub# Deployment Checklists
## Cloudflare Pages Checklist
### Prerequisites
- [ ] Cloudflare account
- [ ] Wrangler CLI installed (optional)
- [ ] D1 database created
### Configuration
- [ ] Build preset: `cloudflare_pages` in `nuxt.config.ts`
- [ ] Build command: `npm run build`
- [ ] Build output: `.output/public`
### D1 Database
- [ ] D1 database created (`nuxt-content-db`)
- [ ] D1 binding configured
- [ ] Binding name is exactly `DB` (case-sensitive)
### Environment Variables
- [ ] `STUDIO_GITHUB_CLIENT_ID` (if using Studio)
- [ ] `STUDIO_GITHUB_CLIENT_SECRET` (if using Studio)
- [ ] Custom env vars as needed
### Deployment
- [ ] GitHub repository connected
- [ ] Build successful
- [ ] D1 binding active
- [ ] Custom domain configured (optional)
- [ ] SSL/TLS verified
### Verification
- [ ] Site loads correctly
- [ ] Content queries work
- [ ] Studio accessible (if configured)
- [ ] No console errors
---
## Cloudflare Workers Checklist
### Configuration
- [ ] Build preset: `cloudflare` in `nuxt.config.ts`
- [ ] `wrangler.toml` configured
- [ ] D1 binding in `wrangler.toml`
### wrangler.toml Example
```toml
name = "nuxt-content-worker"
main = ".output/server/index.mjs"
compatibility_date = "2024-01-01"
[[d1_databases]]
binding = "DB"
database_name = "nuxt-content-db"
database_id = "your-database-id"
```
### Deployment
- [ ] Build: `nuxi build --preset=cloudflare`
- [ ] Deploy: `wrangler deploy`
---
## Vercel Checklist
### Prerequisites
- [ ] Vercel account
- [ ] Vercel CLI installed (optional)
### Configuration
- [ ] Framework: Nuxt (auto-detected)
- [ ] Build command: `npm run build`
- [ ] Output directory: `.output`
### Environment Variables
- [ ] `STUDIO_GITHUB_CLIENT_ID` (if using Studio)
- [ ] `STUDIO_GITHUB_CLIENT_SECRET` (if using Studio)
- [ ] `POSTGRES_URL` (if using Vercel Postgres)
- [ ] Custom env vars as needed
### Database Options
Choose one:
- [ ] SQLite at `/tmp` (default, zero config)
- [ ] Vercel Postgres (create in dashboard)
- [ ] Vercel KV (key-value store)
- [ ] Vercel Blob (file storage)
### Deployment
- [ ] GitHub repository connected
- [ ] Build successful
- [ ] Environment variables added
- [ ] Custom domain configured (optional)
- [ ] SSL certificate active
### Route Rules (Optional)
```ts
routeRules: {
'/': { prerender: true },
'/blog/**': { swr: 3600 }, // Cache 1 hour
'/docs/**': { isr: 3600 }, // ISR
'/_studio/**': { ssr: true }
}
```
### Verification
- [ ] Site loads correctly
- [ ] Content queries work
- [ ] Studio accessible (if configured)
- [ ] Preview deployments work
---
## Netlify Checklist
### Configuration
- [ ] Build command: `npm run build`
- [ ] Publish directory: `.output/public`
- [ ] Functions directory: `.output/server`
### Environment Variables
- [ ] Add Studio credentials (if using)
- [ ] Add custom env vars
### Deployment
- [ ] GitHub connected
- [ ] Build settings configured
- [ ] Deploy successful
---
## General Checklist (All Platforms)
### Pre-Deployment
- [ ] All dependencies installed
- [ ] `content.config.ts` configured
- [ ] Collections defined
- [ ] Content files created
- [ ] Local build successful: `npm run build`
- [ ] Dev server works: `npm run dev`
### Post-Deployment
- [ ] Site accessible
- [ ] Content renders correctly
- [ ] Navigation works
- [ ] Search works (if implemented)
- [ ] Studio works (if configured)
- [ ] No 404 errors
- [ ] No console errors
- [ ] Performance acceptable
### SEO & Meta
- [ ] Meta tags configured
- [ ] OG images working
- [ ] Sitemap generated
- [ ] Robots.txt configured
### Monitoring
- [ ] Error tracking setup
- [ ] Analytics configured
- [ ] Performance monitoring
---
## Hybrid Rendering Configuration
```ts
// nuxt.config.ts
export default defineNuxtConfig({
nitro: {
prerender: {
crawlLinks: true,
routes: ['/']
}
},
routeRules: {
// Static at build time
'/': { prerender: true },
'/about': { prerender: true },
// ISR (Incremental Static Regeneration)
'/blog/**': { isr: 3600 }, // Regenerate every hour
// SWR (Stale While Revalidate)
'/docs/**': { swr: 3600 }, // Cache 1 hour
// Always SSR
'/_studio/**': { ssr: true },
'/api/**': { cors: true }
}
})
```
---
## Troubleshooting
### Build Fails
1. Check build logs
2. Verify all dependencies installed
3. Test locally: `npm run build`
4. Check Node.js version compatibility
### Content Not Loading
1. Verify database configured (D1 or SQLite)
2. Check bindings (Cloudflare)
3. Test queries in development
4. Check console for errors
### Studio Not Working
1. Verify SSR enabled
2. Check OAuth credentials
3. Verify callback URLs
4. Check environment variables
5. Test in development first
### Performance Issues
1. Enable route rules (caching)
2. Prerender static pages
3. Implement pagination
4. Optimize images
5. Use CDN
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |