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/studio-setup-guide.md
View on GitHub# Nuxt Studio Setup Checklist
## Prerequisites
- [ ] Nuxt Content v3 installed
- [ ] GitHub account
- [ ] Production domain (for OAuth)
---
## 1. Install Nuxt Studio
```bash
# Bun
bun add nuxt-studio@alpha
# npm
npm install nuxt-studio@alpha
# pnpm
pnpm add nuxt-studio@alpha
```
---
## 2. Configure nuxt.config.ts
```ts
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@nuxt/content', 'nuxt-studio'],
studio: {
route: '/_studio', // Access route
repository: {
provider: 'github',
owner: 'your-username',
repo: 'your-repo',
branch: 'main'
}
}
})
```
---
## 3. Create GitHub OAuth App
### Production OAuth App
1. Visit: https://github.com/settings/developers
2. Click **New OAuth App**
3. Fill in:
- **Application name**: Your App Name
- **Homepage URL**: `https://yourdomain.com`
- **Authorization callback URL**: `https://yourdomain.com`
4. Click **Register application**
5. Copy the **Client ID**
6. Click **Generate a new client secret**
7. Copy the **Client Secret** (shown only once!)
### Staging OAuth App (Optional)
Create a separate OAuth app for staging:
- **Application name**: Your App Name (Staging)
- **Homepage URL**: `https://staging.yourdomain.com`
- **Callback URL**: `https://staging.yourdomain.com`
---
## 4. Set Environment Variables
### Local Development
```bash
# .env
STUDIO_GITHUB_CLIENT_ID=your_client_id_here
STUDIO_GITHUB_CLIENT_SECRET=your_client_secret_here
```
### Production (Cloudflare)
Add in Cloudflare Dashboard:
- Project → Settings → Environment Variables
- Add `STUDIO_GITHUB_CLIENT_ID`
- Add `STUDIO_GITHUB_CLIENT_SECRET`
### Production (Vercel)
Add in Vercel Dashboard:
- Project → Settings → Environment Variables
- Production scope
- Add both variables
---
## 5. Deployment Configuration
### Required
- ✅ SSR enabled (not static generation)
- ✅ Build command: `nuxt build`
- ✅ Server runtime support
### Hybrid Rendering (Optional)
```ts
// nuxt.config.ts
export default defineNuxtConfig({
routeRules: {
'/': { prerender: true },
'/blog/**': { prerender: true },
'/_studio/**': { ssr: true } // Studio requires SSR
}
})
```
---
## 6. Staging/Preview Setup
### Environment-Based Branch
```ts
// nuxt.config.ts
studio: {
repository: {
provider: 'github',
owner: 'your-username',
repo: 'your-repo',
branch: process.env.STUDIO_GITHUB_BRANCH_NAME || 'main'
}
}
```
### Environment Variables
**Staging**:
```
STUDIO_GITHUB_BRANCH_NAME=staging
STUDIO_GITHUB_CLIENT_ID=staging_client_id
STUDIO_GITHUB_CLIENT_SECRET=staging_client_secret
```
**Production**:
```
STUDIO_GITHUB_BRANCH_NAME=main
STUDIO_GITHUB_CLIENT_ID=production_client_id
STUDIO_GITHUB_CLIENT_SECRET=production_client_secret
```
---
## 7. Access Studio
### Web Interface
```
https://yourdomain.com/_studio
```
### Keyboard Shortcut
Press `Ctrl + .` anywhere on the site
### Login Flow
1. Click "Login with GitHub"
2. Authorize OAuth app
3. Start editing!
---
## 8. Development Mode (Optional)
Enable local file writing:
```ts
studio: {
development: {
sync: true // Writes to local content/
},
repository: {
// ... config
}
}
```
---
## Troubleshooting
### OAuth Fails
- ✅ Callback URL matches exactly (including `https://`)
- ✅ Environment variables set correctly
- ✅ OAuth app not suspended
### Studio Not Accessible
- ✅ SSR is enabled
- ✅ Route is correct (`/_studio`)
- ✅ Module in `modules` array
### Changes Not Saving
- ✅ GitHub token has write permissions
- ✅ Repository configuration correct
- ✅ Check browser console for errors
---
## Complete Checklist
- [ ] Nuxt Studio installed
- [ ] Module added to `nuxt.config.ts`
- [ ] Repository configured
- [ ] GitHub OAuth app created (production)
- [ ] Environment variables set
- [ ] SSR enabled
- [ ] Deployed to hosting platform
- [ ] Studio accessible at `/_studio`
- [ ] Login works
- [ ] Changes commit to GitHub
---
## Advanced: Monorepo Support
```ts
studio: {
repository: {
provider: 'github',
owner: 'your-username',
repo: 'monorepo-name',
branch: 'main',
rootDir: 'apps/website' // Path to Nuxt app
}
}
```
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 |