| 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
bun run build:mcp
Schema alignment
If you add fields or enum values, update in the same PR:
packages/schema/src/schema.tspackages/schema/src/types.tsapps/www/src/content/config.tsapps/www/src/i18n/index.ts (labels/filters)
Checklist
