Skip to content

ChronicStone/nuxt-ui-tools / .agents/skills/nuxt-ui-tools-maintainer

nuxt-ui-tools-maintainer

Verified

Use this skill for internal maintenance and feature work in the nuxt-ui-tools repository. It explains the repository operating model, exact placement rules, how runtime domains relate, how features should be structured and extended, how consumer skills must be maintained, and what to keep in sync when changing the library.

nuxt-ui-tools Maintainer

Use this skill for internal repository work.

This is the main internal maintainer skill. It should be the first deeper skill loaded after AGENTS.md when the task is about implementing, refactoring, organizing, or extending code in this repository.

Read First

  • AGENTS.md
  • .agents/skills/nuxt-ui-tools-maintainer/references/core-approach.md
  • .agents/skills/nuxt-ui-tools-maintainer/references/placement-rules.md
  • .agents/skills/nuxt-ui-tools-maintainer/references/change-workflow.md
  • .agents/skills/nuxt-ui-tools-maintainer/references/consumer-skills.md

Then load the domain reference that matches the task:

  • table runtime: .agents/skills/nuxt-ui-tools-maintainer/references/table-runtime.md
  • query-state runtime: .agents/skills/nuxt-ui-tools-maintainer/references/query-state.md
  • shared runtime: .agents/skills/nuxt-ui-tools-maintainer/references/shared-runtime.md
  • form runtime: .agents/skills/nuxt-ui-tools-maintainer/references/form-runtime.md
  • dashboard runtime: .agents/skills/nuxt-ui-tools-maintainer/references/dashboard-runtime.md
  • display blocks (and the form info field): .agents/skills/nuxt-ui-tools-maintainer/references/display-runtime.md
  • file preview runtime: .agents/skills/nuxt-ui-tools-maintainer/references/file-preview-runtime.md
  • spreadsheet import runtime: .agents/skills/nuxt-ui-tools-maintainer/references/spreadsheet-runtime.md

For technical foundation work, also load the matching skill:

  • TypeScript policy and schema typing: .agents/skills/nuxt-ui-tools-typescript/SKILL.md
  • lean reactivity and query-state integration: .agents/skills/nuxt-ui-tools-reactivity/SKILL.md
  • config/registry-driven feature architecture: .agents/skills/nuxt-ui-tools-config-driven/SKILL.md

What This Skill Exists To Solve

It should make two things easy:

  1. maintenance and development by both AI agents and humans
  2. adoption of the library by package consumers

That means internal code decisions should optimize for:

  • clear placement
  • low cognitive load
  • modular structure
  • predictable extension patterns
  • stable and discoverable consumer surfaces

Core Internal Rule

When making changes, always think in both directions:

  • inward: does this make the codebase easier to understand, evolve, and validate?
  • outward: does this make the package easier to use, document, and teach?

If a change improves implementation convenience but makes consumer usage or future maintenance worse, it is probably the wrong move.

What Agents Must Be Able To Answer

After reading this skill, an agent should be able to answer all of these quickly:

  • which runtime domain owns the change
  • which layer inside that domain owns the change
  • whether the feature should be config-driven, registry-driven, or a simpler direct abstraction
  • whether complexity should be absorbed by the package instead of leaking to consumers
  • which tests, playground routes, consumer skills, and internal references must be updated

If the current guidance does not make those answers obvious, improve the guidance as part of the task.

Internal Routing

If the task is about:

  • overall repository structure, placement, or feature organization: use core-approach.md and placement-rules.md
  • extension workflow or how to land a feature cleanly: use change-workflow.md
  • table internals: use table-runtime.md
  • query-state internals: use query-state.md
  • TypeScript and type-system shaping: use .agents/skills/nuxt-ui-tools-typescript/SKILL.md
  • reactive state design: use .agents/skills/nuxt-ui-tools-reactivity/SKILL.md
  • config-driven or registry-driven architecture: use .agents/skills/nuxt-ui-tools-config-driven/SKILL.md
  • consumer-facing package skill maintenance: use consumer-skills.md

Skill Split Reminder

Internal maintainer guidance belongs in:

  • .agents/skills/

Consumer package guidance belongs in:

  • skills/consumer/

Do not mix them.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall