NU

nuxt-content

Provides guidance for Nuxt Content v3, including typed collections, database configuration, and dynamic rendering.

Install

mkdir -p .claude/skills/nuxt-content && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1833" && unzip -o skill.zip -d .claude/skills/nuxt-content && rm skill.zip

Installs to .claude/skills/nuxt-content

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use when working with Nuxt Content v3, markdown content, or CMS features in Nuxt - provides collections (local/remote/API sources), queryCollection API, MDC rendering, database configuration, NuxtStudio integration, hooks, i18n patterns, and LLMs integration
258 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • Define content collections with schemas
  • Query content collections
  • Render MDC content
  • Configure database for content
  • Integrate with NuxtStudio
  • Handle i18n multi-language content

How it works

This skill provides guidance for content-driven Nuxt applications by managing typed content collections and enabling SQL-backed queries across various content sources.

Inputs & outputs

You give it
Content files, schemas, and queries
You get back
Rendered content or queried data

When to use nuxt-content

  • Define a content collection with a schema
  • Query local markdown files
  • Implement MDC rendering components
  • Configure SQL-backed content sources

About this skill

Nuxt Content

Workflow

  1. Inspect the installed @nuxt/content version, content.config.ts, matching files under content/, and the Nuxt surface that consumes them. The branch is understood when the collection, source glob, schema, and consumer agree.
  2. Open the smallest matching guide below. Apply Nuxt Content guidance only to content-owned APIs; use Nuxt, Nuxt Studio, Nuxt UI, or Vue guidance when those packages own the remaining surface.
  3. Implement with typed collections and payload-backed Nuxt data loading. The change is complete when collection types resolve, the intended query returns the expected document shape, and the rendered route works in the target rendering mode.

Routing

TaskOpen
Collection types, schemas, indexes, local/remote sources, or locale prefixesCollections
Filtering, sorting, pagination, navigation, surroundings, or searchQuerying
Markdown, MDC, ContentRenderer, prose components, or code highlightingRendering
Database adapters, markdown processing, renderer aliases, or deployment storageConfiguration
Hooks, transformers, custom sources, raw content, debugging, or Content v2 migrationAdvanced
Visual editing, authentication, media, drafts, or Git publishingnuxt-studio skill
Writing or restructuring documentation prosedocument-writer skill

Baseline

// content.config.ts
import { defineCollection, defineContentConfig } from '@nuxt/content'
import { z } from 'zod'

export default defineContentConfig({
  collections: {
    docs: defineCollection({
      type: 'page',
      source: 'docs/**',
      schema: z.object({
        updatedAt: z.date().optional(),
      }),
    }),
  },
})
<script setup lang="ts">
const route = useRoute()
const { data: page } = await useAsyncData(route.path, () => {
  return queryCollection('docs').path(route.path).first()
})
</script>

<template>
  <ContentRenderer v-if="page" :value="page" />
</template>

Use npx nuxi typecheck to verify generated collection types. When a query is empty, confirm that its collection source includes the file—especially .navigation.yml—before changing query logic.

When not to use it

  • For writing general documentation
  • For basic Nuxt tasks
  • For NuxtHub deployment

Limitations

  • Requires Nuxt Content v3
  • Not for general documentation writing
  • Not for basic Nuxt tasks

How it compares

It offers structured content management with type-safe queries and MDC rendering, unlike manual content handling in Nuxt.

Compared to similar skills

nuxt-content side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
nuxt-content (this skill)35moNo flagsIntermediate
fullstack-developer05moReviewAdvanced
development05moNo flagsAdvanced
dapp01moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

motion

onmax

Use when adding animations with Motion Vue (motion-v) - provides motion component API, gesture animations, scroll-linked effects, layout transitions, and composables for Vue 3/Nuxt

1044

nuxthub-migration

onmax

Use when migrating NuxtHub projects or when user mentions NuxtHub Admin sunset, GitHub Actions deployment removal, self-hosting NuxtHub, or upgrading to v1/nightly. Covers v0.9.X self-hosting (stable) and v1/nightly multi-cloud (experimental, database/blob not ready).

589

vueuse

onmax

Use when working with VueUse composables - provides reactive utilities for state, browser APIs, sensors, network, animations. Check VueUse before writing custom composables - most patterns already implemented.

417

document-writer

onmax

Use when writing blog posts or documentation markdown files - provides writing style guide (active voice, present tense), content structure patterns, and MDC component usage. Overrides brevity rules for proper grammar. Use nuxt-content for MDC syntax, nuxt-ui for component props.

325

nuxt-modules

onmax

Use when creating Nuxt modules: (1) Published npm modules (@nuxtjs/, nuxt-), (2) Local project modules (modules/ directory), (3) Runtime extensions (components, composables, plugins), (4) Server extensions (API routes, middleware), (5) Releasing/publishing modules to npm, (6) Setting up CI/CD workflows for modules. Provides defineNuxtModule patterns, Kit utilities, hooks, E2E testing, and release automation.

318

reka-ui

onmax

Use when building with Reka UI (headless Vue components) - provides component API, accessibility patterns, composition (asChild), controlled/uncontrolled state, virtualization, and styling integration. Formerly Radix Vue.

38

Search skills

Search the agent skills registry