Skip to content

docs(skills): add @nuxtjs/robots Skill - #339

Open
harlan-zw wants to merge 2 commits into
mainfrom
feat/package-skill
Open

harlan-zw wants to merge 2 commits into
mainfrom
feat/package-skill

Conversation

@harlan-zw

Copy link
Copy Markdown
Contributor

🔗 Linked issue

Related to #338

❓ Type of change

  • 📖 Documentation (updates to the documentation or readme)
  • 🐞 Bug fix (a non-breaking change that fixes an issue)
  • 👌 Enhancement (improving an existing functionality)
  • ✨ New feature (a non-breaking change that adds functionality)
  • 🧹 Chore (updates to the build process or auxiliary tools and libraries)
  • ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

The README links a skilld.dev Skill page, but the repository has no Skill, so the page is empty. The other Nuxt SEO modules already ship one. This adds a package Skill at skills/nuxtjs-robots/SKILL.md, with a reference for Nuxt Content and i18n, tested against 6.2.4. It ships in the npm package through files.

It covers where site-wide indexing lives (site, not robots), what the module does automatically, route rules and useRobotsRule(), bot detection, and the traps an Agent hits on staging. Once this merges, Skillgen can keep the Skill current after each release tag. The package bugs found while writing it are in #338.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

Agents misuse this module in ways the types do not catch: definePageMeta
robots rules that never apply, per-host robots:config hooks that leak
across requests, and staging builds that still send indexable headers.
The Skill records the 6.2.4 behaviour observed in a consumer fixture.

Ship the skills directory in the npm package so installed copies carry
the Skill for the installed version.
An independent review found that the search example made a staging page
indexable, because useRobotsRule(true) overrides a site that is not
indexable. It also found five silent failure paths the Skill did not
state: bot trust and header casing, app/ robots.txt paths, the zod 3
fallback in Content, and the literal null header.

Each finding was reproduced against 6.2.4 before the edit. Package bugs
now sit under the 6.2.4 version limits, so the next release can drop
the ones that no longer reproduce.
@harlan-zw harlan-zw added the harlan-agent-review Approve automated work for the current issue state or pull request head commit. label Oct 7, 2026
@pkg-pr-new

pkg-pr-new Bot commented Oct 7, 2026

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/@nuxtjs/robots@339

commit: cdd6084

@harlan-zw harlan-zw added harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. and removed harlan-agent-review Approve automated work for the current issue state or pull request head commit. labels Oct 7, 2026
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown

📦 Package Size

✅ No notable size changes

All tracked output (10)
Package output Gzipped Raw
@nuxtjs/robots · dependency @fingerprintjs/botd 13 kB 55 kB ✅
@nuxtjs/robots · dependency @vueuse/core 178 kB 720 kB ✅
@nuxtjs/robots · dependency nuxt-site-config 11 kB 29 kB ✅
@nuxtjs/robots · dependency nuxtseo-shared 32 kB 107 kB ✅
@nuxtjs/robots · export . 6.4 kB 24 kB ✅
@nuxtjs/robots · export ./content 292 B 503 B ✅
@nuxtjs/robots · export ./util 6.6 kB 25 kB ✅
@nuxtjs/robots · published payload 40 kB 131 kB ✅
@nuxtjs/robots · app runtime 3.2 kB 7.0 kB ✅
@nuxtjs/robots · server runtime 9.7 kB 23 kB ✅
Runtime dependencies (8)
Package Dependency Requested Resolved Cost
@nuxtjs/robots @fingerprintjs/botd ^2.0.0 2.0.0 📦 13 kB gzip
@nuxtjs/robots @nuxt/kit ^4.6.0 4.6.0 ♻️ free via Nuxt 4.6.0
@nuxtjs/robots @vueuse/core ^15.0.0 15.0.0 📦 178 kB gzip
@nuxtjs/robots consola ^3.4.2 3.4.2 ♻️ free via Nuxt 4.6.0
@nuxtjs/robots defu ^6.1.7 6.1.7 ♻️ free via Nuxt 4.6.0
@nuxtjs/robots nuxt-site-config ^5.0.0 5.0.0 📦 11 kB gzip
@nuxtjs/robots nuxtseo-shared ^6.0.0 6.0.0 📦 32 kB gzip
@nuxtjs/robots ufo ^1.6.4 1.6.4 ♻️ free via Nuxt 4.6.0

Baseline: main_@_86908c3___2026-10-06 · gzip is the comparison metric · changes below 16 B gzip are ignored

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant