up

Author: benjamincanac

skills/nuxt-ui/SKILL.md

@@ -83,7 +83,7 @@ Based on the task, load the relevant reference files **before writing any code**
 | Add a modal, slideover, or drawer | conventions, component-selection, overlays |
 | Build site navigation | conventions, component-selection, navigation |
 | Build a documentation site | conventions, docs |
-| Render markdown | component-selection, docs |
+| Render markdown | component-selection, components, docs |
 | Add a rich text editor | conventions, editor |
 | General UI work | conventions, component-selection |
 

skills/nuxt-ui/references/components.md

@@ -153,7 +153,26 @@ Quick-reference index of all 125+ components. For full API docs (props, slots, e
 | `UPricingPlan` | Individual pricing plan card |
 | `UPricingTable` | Feature comparison table |
 
-## Prose (Markdown)
+## Prose — Base Typography
+
+Standard Markdown elements auto-resolved by Comark/Content/MDC. No `::` prefix needed — they map directly from markdown syntax (`# Heading` → `ProseH1`, `**bold**` → `ProseStrong`, etc.). Themed via `appConfig.ui.prose.<name>`.
+
+| Component | Renders | Notable |
+|---|---|---|
+| `H1` `H2` `H3` `H4` | Headings | H1–H3 get anchor links + TOC entries |
+| `P` | Paragraph | |
+| `A` | Link | External links get target/rel handling |
+| `Strong` | Bold | |
+| `Em` | Italic | |
+| `Blockquote` | Blockquote | |
+| `Hr` | Horizontal rule | |
+| `Ul` `Ol` `Li` | Lists | Supports nesting and mixed lists |
+| `Table` `Thead` `Tbody` `Tr` `Th` `Td` | Tables | |
+| `Img` | Image | Zoom on click (`:zoom="false"` to disable), `@nuxt/image` support |
+| `Pre` | Code block | Copy button, filename + icon, line highlighting (`{2,4-6}`), diff |
+| `Code` | Inline code | `color` and `lang` props |
+
+## Prose — Feature Components
 
 Nuxt UI-specific Prose components. In markdown files they are used **without the `Prose` prefix** (e.g. `::callout`, `::steps`). In Vue they are referenced as `ProseCallout`, `ProseSteps`, etc. Comark resolves them automatically when `@nuxt/ui` is installed.
 

skills/nuxt-ui/references/guidelines/component-selection.md

@@ -85,7 +85,7 @@ Decision matrices for choosing the right component. When in doubt, use the MCP `
 
 ## Markdown
 
-When rendering markdown (for instance with Comark), **prefer Prose components** — they are styled and tuned for markdown contexts. Generic Nuxt UI components can also be used. `<ComarkRenderer>` (or `<Comark>`) auto-resolves `ProseX` components when `@nuxt/ui` is installed. In markdown, the `Prose` prefix can be omitted (`::callout`, `::steps`, etc.).
+When rendering Markdown (for instance with Comark), **prefer Prose components** — they are styled and tuned for Markdown contexts. Generic Nuxt UI components can also be used. `<ComarkRenderer>` (or `<Comark>`) auto-resolves `ProseX` components when `@nuxt/ui` is installed. In Markdown, the `Prose` prefix can be omitted (`::callout`, `::steps`, etc.).
 
 | Need | Use | Not |
 |---|---|---|
@@ -100,9 +100,6 @@ When rendering markdown (for instance with Comark), **prefer Prose components**
 - Prose components use native Vue slots — Comark maps named `#slot` blocks directly to `<slot name="..." />`
 - Theme via `appConfig.ui.prose.<name>` using the same override pattern as other Nuxt UI components
 - `Callout` colors: `neutral` (default), `primary`, `secondary`, `info`, `success`, `warning`, `error`
-- Shorthand callout aliases: `::note`, `::tip`, `::warning`, `::caution` — expand to `Callout` with preset color + icon
-- `Tabs` `sync` prop persists selected tab to localStorage; `hash` scrolls to an anchor on tab change
-- `Steps` `level` prop sets the heading level the step titles map to (default: `3`)
 
 ## Layout containers