nuxt-content
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
95
93%
Does it follow best practices?
Impact
97%
1.27xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly identifies its niche (Nuxt Content v3), lists specific capabilities, and includes an explicit 'Use when...' trigger clause. The trigger terms are natural and comprehensive, covering both the framework name and specific API/feature terms developers would reference. The description is concise yet thorough, making it easy for Claude to select this skill appropriately.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and features: collections (local/remote/API sources), queryCollection API, MDC rendering, database configuration, NuxtStudio integration, hooks, i18n patterns, and LLMs integration. These are concrete, identifiable capabilities. | 3 / 3 |
Completeness | Explicitly answers both 'what' (collections, queryCollection API, MDC rendering, database configuration, etc.) and 'when' ('Use when working with Nuxt Content v3, markdown content, or CMS features in Nuxt'). The 'Use when...' clause is present and clear. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Nuxt Content v3', 'markdown content', 'CMS features', 'Nuxt', 'collections', 'queryCollection', 'MDC', 'NuxtStudio', 'i18n'. These cover the primary terms a developer working with this framework would use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: Nuxt Content v3 specifically. The combination of 'Nuxt Content v3', 'queryCollection', 'MDC rendering', and 'NuxtStudio' makes it very unlikely to conflict with generic markdown, CMS, or other Nuxt skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that excels at conciseness, actionability, and progressive disclosure. It provides a complete Quick Start with executable code and verification, while cleanly deferring detailed topics to reference files. The main weakness is that workflow clarity for multi-step operations (database setup, remote sources, migration) is entirely delegated to sub-files without any preview of those workflows in the main skill.
Suggestions
Consider adding a brief 2-3 step workflow outline for common multi-step operations (e.g., adding a remote source or configuring a database) with validation checkpoints, even if details are in reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient. It assumes Claude's competence with Nuxt and content management concepts, avoids explaining what markdown or SQL are, and every section serves a clear purpose. The token efficiency note at the bottom is a nice touch. | 3 / 3 |
Actionability | Provides fully executable Quick Start code with both the content.config.ts and the Vue page component. Includes a concrete verification step ('npx nuxi typecheck') and troubleshooting guidance for empty queryCollection results. The Key Concepts table gives precise, actionable distinctions (page vs data). | 3 / 3 |
Workflow Clarity | The Quick Start provides a clear two-file setup sequence with a verification step, which is good. However, there's no explicit workflow for more complex operations like adding remote sources, configuring databases, or migrating content — these are deferred to reference files. The checklist for loading files is helpful but is more about navigation than workflow sequencing. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure with a clear overview, well-signaled one-level-deep references to five specific sub-files, a checklist pattern for selective loading, and an explicit instruction not to load all files at once. Cross-references to related skills (document-writer, nuxt, nuxthub) are also well-structured. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- onmax/nuxt-skills
- Commit
3110745
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.