Devverse Content Mdx

MDX article conventions for DevVerse. Use when adding or editing files under content/, changing article metadata, updating author or date lines, or modifying code that parses article content for feeds, related posts, reading stats, or RAG ingestion.

hoangsonww 5aad287 3 files · 2.9 KB Updated

File contents

DevVerse MDX Content Workflow

  1. Treat content/*.mdx as the canonical article store. Do not model article changes around supabase/articles.sql; runtime content comes from MDX files.

  2. Keep the article contract stable. Use a literal export const metadata = { title, description, topics };, keep ### Author: ..., keep > Date: YYYY-MM-DD, and keep the article body starting with a top-level # heading.

  3. Use the checked-in template when creating a new article. @templates/article-template.mdx

  4. Read the contract notes before changing metadata conventions. @references/article-contract.md

  5. If you change metadata shape or article template rules, update every dependent parser in the same task.

  6. After content edits, run python3 .claude/scripts/check_content_contract.py.

  7. After content edits that should affect chat retrieval, consider devverse-refresh-vectors.

hoangsonww/devverse-swe-blog/tree/main/.claude/skills/devverse-content-mdx commit 5aad287054

Frequently asked questions

npx skillmds@latest add hoangsonww/devverse-content-mdx-2