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/consumer-skills.md
View on GitHub# Consumer Skills Maintenance
Use this reference when changing or auditing `skills/consumer/*`.
## Goal
Consumer skills are not lightweight notes.
They are the package's AI-facing usage documentation.
They should make adoption easy by answering:
- what the user imports
- what the user writes
- what the valid options are
- what behavior or URL shape results
- what defaults, edge cases, and gotchas matter in practice
## Hard Separation
Consumer skills must not contain:
- playground guidance
- internal file-routing
- maintainer language about how the repository is organized
- aspirational statements about what the package should eventually do
Consumer skills must contain:
- current exported APIs
- current behavior
- concrete examples
- concrete result shapes
- practical caveats when they matter
## Writing Standard
Prefer this order inside a feature reference:
1. what this part of the API is for
2. the code the consumer writes
3. the resulting state, URL, or rendered behavior
4. important options
5. gotchas or edge cases
## Example Quality Bar
Bad:
- abstract prose with no code
- generic statements like "the package manages this for you"
- maintainer-only explanations
Good:
- realistic `defineTableSchema(...)` examples
- realistic `useQueryState(...)` / `useQueryStates(...)` examples
- example query strings
- example option values
- example result shapes
## Maintenance Rule
When a user-facing surface changes, update the matching consumer skill in the same task.
That includes:
- new options
- renamed keys
- changed defaults
- changed URL serialization
- new supported patterns
- removed behavior
## Translation Guidance Must Be Explicit
When a schema or component surface accepts user-facing text, consumer skills should say clearly whether that text belongs to:
- package-owned locale messages, or
- consumer-owned schema text
For consumer-owned schema text, document the lazy translation pattern directly:
- prefer `() => t('...')`
- do not recommend rebuilding the whole schema in `computed(...)` just to change language
- do not recommend ad hoc bilingual helpers when translation keys are available
If a task adds lazy text support to a new surface, update the matching consumer skill with at least one concrete i18n example in the same task.
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 |