feat(marketplace): add nuxt-i18n plugin to marketplace

[amondnet]

Summary

• Add nuxt-i18n as a new standalone plugin to the marketplace
• Generate skills from official @nuxtjs/i18n documentation (https://i18n.nuxtjs.org/llms-full.txt)
• Update marketplace config and release-please config to include the new plugin

Changes

Plugin

• New standalone plugin at plugins/nuxt-i18n/ with .claude-plugin/plugin.json
• Skills generated from official documentation covering 9 reference areas:
  • Configuration options and setup
  • Routing strategies (prefix, prefix_except_default, prefix_and_default, no_prefix)
  • Browser language detection and locale switching
  • SEO and meta tag management
  • Lazy loading for translations
  • Per-component translations
  • Domain-based localization
  • Server-side rendering and Nuxt hooks
  • API reference (useI18n, $i18n, composables)

Documentation Compression

• Original source: 4,366 lines from llms-full.txt
• Compressed to: 1,070 lines across 9 reference files (75% reduction)

Configuration Updates

• .claude-plugin/marketplace.json — added nuxt-i18n plugin entry
• release-please-config.json — added nuxt-i18n to release tracking

Test Plan

• Verify plugin installs correctly via /plugin install nuxt-i18n@pleaseai
• Confirm skills load when working on Nuxt i18n tasks
• Validate marketplace.json schema passes claude plugin validate

---

Summary by cubic

Added nuxt-i18n as a marketplace plugin with generated skills from @nuxtjs/i18n docs to support locale routing, lazy-loaded translations, SEO, browser detection, and multi-domain setups. Updated marketplace and release tracking to ship the new plugin.

• New Features

  • New plugin at plugins/nuxt-i18n/ with .claude-plugin/plugin.json and entry in .claude-plugin/marketplace.json.
  • Skills generated from https://i18n.nuxtjs.org/llms-full.txt, compressed into 9 focused reference files.
  • Coverage includes configuration, routing strategies, detection/switcher, SEO, lazy loading, per-component translations, domain setups, server hooks, and API composables/components.
  • Added plugins/nuxt-i18n: "1.0.0" to .release-please-manifest.json and release rules in release-please-config.json (tracks version via .claude-plugin/plugin.json).

• Bug Fixes

  • Removed duplicate skills directory; set plugin author to “Nuxt Community” for proper attribution.
  • Docs: added 'page' to customRoutes type, clarified useLocaleHead() returns a Ref, linked llms-full.txt, and noted using <NuxtLinkLocale> for named routes.

^{Written for commit 8245b7a. Summary will update on new commits.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
claude-code-plugins	Ready	Preview, Comment	Mar 28, 2026 1:46pm

[gemini-code-assist]

Code Review

This pull request introduces the nuxt-i18n plugin, adding it to the marketplace and release configurations while providing extensive documentation and skills for internationalization features like routing, SEO, and lazy loading. Feedback was provided to update the author field in the plugin configuration to credit the upstream organization using the correct object structure.

[cubic-dev-ai]

2 issues found across 26 files

Confidence score: 4/5

• This PR looks safe to merge with minimal risk: both findings are low-severity documentation inconsistencies (4/10) rather than runtime or behavioral defects.
• Most severe issue is in skills/nuxt-i18n/references/core-configuration.md, where customRoutes excludes 'page' in the type while declaring it as default, which can mislead readers and create configuration confusion.
• skills/nuxt-i18n/references/core-routing.md has mismatched guidance versus example (localePath() recommendation vs <NuxtLinkLocale> snippet), which may cause onboarding friction for plugin users.
• Pay close attention to skills/nuxt-i18n/references/core-configuration.md and skills/nuxt-i18n/references/core-routing.md - resolve the doc/API consistency gaps to avoid user confusion.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="skills/nuxt-i18n/references/core-configuration.md">

<violation number="1" location="skills/nuxt-i18n/references/core-configuration.md:59">
P2: The `customRoutes` option type excludes `'page'` while the same row declares `'page'` as default. Include `'page'` in the union type so the option definition is self-consistent.</violation>
</file>

<file name="skills/nuxt-i18n/references/core-routing.md">

<violation number="1" location="skills/nuxt-i18n/references/core-routing.md:74">
P2: This guidance is inconsistent with its own example (`localePath()` is recommended, but the snippet uses `<NuxtLinkLocale>`). Align the instruction with the demonstrated API to avoid confusing plugin users.</violation>
</file>

Architecture diagram

sequenceDiagram
    participant User
    participant Agent as Claude / AI Agent
    participant Market as Marketplace Registry
    participant Plugin as nuxt-i18n Plugin
    participant App as Nuxt Application

    Note over User,App: Plugin Discovery & Installation
    User->>Agent: "Install nuxt-i18n plugin"
    Agent->>Market: NEW: Lookup "nuxt-i18n" in marketplace.json
    Market-->>Agent: Return plugin metadata & source path
    Agent->>Plugin: Load .claude-plugin/plugin.json
    Plugin-->>Agent: Return version (1.0.0) and skill definitions

    Note over User,App: Contextual Assistance Flow (Runtime)
    User->>Agent: "How do I configure SEO for my French locale?"
    Agent->>Plugin: NEW: Access .agents/skills/nuxt-i18n/SKILL.md
    Plugin->>Plugin: Resolve reference to features-seo.md
    Plugin-->>Agent: Return compressed SEO documentation
    
    Agent->>Agent: Process i18n routing strategy & baseUrl
    
    Agent->>App: NEW: Suggest nuxt.config.ts i18n block
    Agent->>App: NEW: Inject useLocaleHead() logic into layout

    Note over App,App: App Runtime Behavior (Result)
    App->>App: Apply "prefix_except_default" strategy
    App->>App: Generate hreflang tags for SEO
    App->>App: Lazy-load translation files from /i18n/locales/

Loading

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[amondnet]

Applied Review Suggestions (8245b7a)

1. @gemini-code-assist - ✅ Applied: Changed author to Nuxt Community for upstream attribution
2. @cubic-dev-ai (customRoutes) - ✅ Already fixed in df6770e: Type updated to 'page' | 'meta' | 'config', duplicate skills/ dir removed
3. @cubic-dev-ai (named routes) - ✅ Applied: Clarified guidance to include <NuxtLinkLocale>