ChronicStone/nuxt-ui-tools / .agents/skills/nuxt-ui-tools-maintainer
nuxt-ui-tools-maintainer
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.3 KB |
| references/change-workflow.md | markdown | 2.2 KB |
| references/consumer-skills.md | markdown | 2.2 KB |
| references/core-approach.md | markdown | 3.8 KB |
| references/dashboard-runtime.md | markdown | 27.8 KB |
| references/display-runtime.md | markdown | 3.5 KB |
| references/file-preview-runtime.md | markdown | 4.4 KB |
| references/form-runtime.md | markdown | 14.9 KB |
| references/placement-rules.md | markdown | 3.6 KB |
| references/query-state.md | markdown | 1.8 KB |
| references/shared-runtime.md | markdown | 809 B |
| references/spreadsheet-runtime.md | markdown | 6.0 KB |
| references/table-runtime.md | markdown | 8.0 KB |
references/query-state.md
View on GitHub# Query State Runtime
The query-state runtime is a reusable primitive layer.
## Current Main Files
- `src/runtime/query-state/index.ts`
- `src/runtime/query-state/codecs.ts`
- `src/runtime/query-state/client.ts`
- `src/runtime/query-state/composables.ts`
## Current Public Surface
Today this domain exports:
- `useQueryState(...)`
- `useQueryStates(...)`
- `dynamicQueryState(...)`
- built-in codecs
- the client and client registration helpers
## What Belongs Here
- URL/query-param primitives
- codecs
- generic grouped state logic
- dynamic state logic
- router/client integration
## What Does Not Belong Here
- table-specific domain behavior unless it is just a thin adapter layer
## Internal Rules
- keep abstractions lean
- prefer one direct abstraction over multiple wrappers
- use `shallowRef` when deep reactivity does not add value
- do not over-model with unnecessary computed bridges
## Current Design Intention
The purpose of this domain is to let larger features model URL state directly and cleanly.
That means:
- single values should not require custom parse/stringify glue everywhere
- grouped values should avoid manual synchronization
- dynamic key sets should be modeled as first-class abstractions when the keys come from runtime definitions
## Current Known Cleanup Direction
The abstraction is useful, but some downstream usage still shows too much bridging.
When touching this area, prefer:
- strengthening grouped or dynamic abstractions
- reducing domain-level re-shaping computed wrappers
- keeping URL ownership clear
- making table/query-state integration more direct
## Important Consumer-Simplicity Rule
This layer exists so larger package surfaces and app code can get typed URL state without manual parsing.
If a use case feels too awkward here:
- improve the abstraction
- do not normalize workaround-heavy usage
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |