content-authoring

name	content-authoring
description	Add or edit library resources in packages/content/resources with frontmatter, snippets, and MCP catalog regeneration. Use for any new resource type — components, patterns, prompts, animations, schemas, etc.
metadata	{"tags":"content, mdx, snippets, schema, mcp, library"}

Content Authoring

Canonical source of truth: packages/content/resources/<slug>/. Full reference: CONTENT_AUTHORING.md.

When to use

• Any new Library resource (component, pattern, prompt, animation, schema, boilerplate, …)
• Editing frontmatter, snippets, or README prose for an existing resource
• After content changes that affect the MCP catalog

Quick start

packages/content/resources/my-resource/
  index.mdx
  snippets/
    html.html          # if targets includes html
    style.css
    script.js
    react.tsx          # if targets includes react

Minimum valid frontmatter

---
slug: my-resource
title: My Resource
description: One sentence explaining what it is.
category: ui-components
type: component
difficulty: med
createdAt: 2026-06-12
updatedAt: 2026-06-12
---

Recommended frontmatter

Add tags, tech, targets, collections, labRoute, license, and author for discoverability.

Category ↔ type pairs

Category	Type	Use for
ui-components	component	Buttons, forms, cards, widgets
components	component	React-oriented reusable blocks
pages	page	Full page layouts → see page-resources
web-animations	animation	Motion, scroll, canvas, WebGL
patterns	pattern	UX interaction patterns
prompts	prompt	AI prompt templates
skills	skill	Agent skill definitions
database-schemas	schema	SQL / ERD resources
recommendations	recommendation	Tool comparison topics (no code, no Lab)

Do not invent new category/type values without updating the schema (see add-collection for the wiring list).

Snippet targets

Target	File
html	snippets/html.html
react	snippets/react.tsx
next	snippets/next.tsx
vue	snippets/vue.vue
svelte	snippets/svelte.svelte
astro	snippets/astro.astro
typescript	snippets/typescript.ts
sql	snippets/schema.sql, seed.sql, queries.sql
markdown	snippets/markdown.md

Only declare targets you actually ship.

Lab demos

Set labRoute: /<category>/<slug> and provide html.html (+ linked style.css / script.js). Lab inlines assets at build time in apps/lab.

Post-change commands

bun run --filter @stealthis/mcp catalog
bun run lint
bun run build:www
bun run build:lab    # if labRoute set
bun run build:mcp    # if metadata affects MCP tools

Schema alignment

If you add fields or enum values, update in the same PR:

• packages/schema/src/schema.ts
• packages/schema/src/types.ts
• apps/www/src/content/config.ts
• apps/www/src/i18n/index.ts (labels/filters)

Checklist

• Folder packages/content/resources/<slug>/
• Valid frontmatter (Zod schema passes)
• Snippet files match targets
• MDX body documents usage
• MCP catalog regenerated
• Lint + relevant builds pass