CtrlK
BlogDocsLog inGet started
Tessl Logo

nuxt-content

Build typed, content-driven Nuxt applications with @nuxt/content. Use when working with content.config.ts, collections, queryCollection, Markdown or MDC rendering, content databases, hooks, custom sources, search, or Content v2 migrations.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary skill overview: a lean workflow with explicit done-criteria and validation, a routing table verified against real one-level-deep reference files, and a fully executable baseline with a verification command and an error-recovery hint. No dimension shows a weakness worth penalizing.

DimensionReasoningScore

Conciseness

The ~50-line body is lean and assumes Claude's competence: no concept explanations, no library recommendations, no padding. Every element earns its place — the workflow steps state done-criteria ("The branch is understood when the collection, source glob, schema, and consumer agree"), the routing table is one line per topic, and the baseline is code plus one verification command. This matches the 'lean and efficient; every token earns its place' anchor, not 4 since there is nothing to trim.

5 / 5

Actionability

The Baseline gives two complete, copy-paste-ready examples (a full content.config.ts collection definition and a Vue page that queries and renders it), a concrete verification command ("npx nuxi typecheck"), and a specific debugging fact (a query can be empty because the source glob excludes `.navigation.yml`). This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'; score 4 would require gaps in executability, which are absent.

5 / 5

Workflow Clarity

The three-step workflow is clearly sequenced with explicit validation checkpoints — step 1 defines a done-criterion, step 3 requires that "collection types resolve, the intended query returns the expected document shape, and the rendered route works", and the Baseline supplies the verification command plus an error-recovery loop ("When a query is empty, confirm that its collection source includes the file ... before changing query logic"). This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery', not 4, because both validation and recovery guidance are explicit rather than implied.

5 / 5

Progressive Disclosure

The Routing table gives a clear task-to-reference map, all five referenced files (collections.md, querying.md, rendering.md, config.md, advanced.md) exist in ./references/ and are one level deep, and out-of-scope topics are explicitly routed to sibling skills (`nuxt-studio`, `document-writer`). This matches the 5 anchor ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'); a lateral link from config.md to advanced.md stays one level from SKILL.md and does not constitute nesting.

5 / 5

Total

20

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-constructed description with an explicit what-and-when structure and strong package-specific trigger terms. Its main weakness is that the capability statement is a single action ('Build typed, content-driven Nuxt applications') rather than an enumeration of what the skill does, and a few generic trigger words create minor conflict risk with adjacent skills.

Suggestions

Enumerate 2-3 more concrete capabilities in the opening sentence (e.g., 'Define typed collections in content.config.ts, query them with queryCollection, and render Markdown/MDC') to raise specificity from naming the domain to listing actions.

Add commonly-used trigger phrases that are currently missing, such as 'navigation', 'ContentRenderer', or 'Nuxt Content docs', to broaden natural keyword coverage.

Qualify the generic terms to reduce conflict risk, e.g., 'Markdown or MDC rendering in Nuxt Content' instead of bare 'Markdown ... rendering' that could match general Markdown skills.

DimensionReasoningScore

Specificity

"Build typed, content-driven Nuxt applications with @nuxt/content" names the domain and one concrete action, but the description stops there and shifts to trigger terms rather than enumerating capabilities (e.g., defining collections, querying, rendering). It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; not 4 because several specific actions are not listed, not 2 because the action given is concrete rather than generic.

3 / 5

Completeness

It explicitly answers both questions: "Build typed, content-driven Nuxt applications with @nuxt/content" (what) and "Use when working with content.config.ts, collections, queryCollection, ... or Content v2 migrations" (when, with concrete trigger phrases). This mirrors the anchor-5 example structure; score 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

The trigger list covers strong natural terms users would say: "content.config.ts", "collections", "queryCollection", "Markdown or MDC rendering", "hooks", "custom sources", "search", and "Content v2 migrations". A few commonly-said terms are missing (navigation, ContentRenderer, docs/.md files, synonyms for the package itself), so it sits at 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym/extension coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The @nuxt/content niche is clear and most triggers are package-specific APIs, but generic words like "Markdown or MDC rendering", "search", and "hooks" carry minor overlap risk with general Markdown/search skills and closely related Nuxt-family skills. This fits 'mostly distinct; minor overlap risk with closely related skills' better than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
onmax/nuxt-skills
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.