Jsx Md Authoring

JSX-MD Authoring

Use this skill for prompt components and Markdown rendering code.

Read First

• packages/jsx-md/README.md
• packages/jsx-md/src/primitives.tsx
• packages/jsx-md/src/render.ts
• packages/jsx-md/src/context.ts

Authoring Rules

• Prefer JSX-MD components over inline Markdown strings.
• Use lowercase XML intrinsics for structured LLM prompt sections such as `, , and `.
• Use Md only as an escape hatch for genuinely undecomposable Markdown.
• Escape user-supplied strings with Escape or escapeMarkdown when they should render literally.
• Use Codeblock for fenced code and let it choose a safe fence length.
• Keep render() deterministic and synchronous.
• Do not introduce React or DOM runtime assumptions into jsx-md.
• Use context only for cross-cutting rendering state, not arbitrary global state.

Text Rules

• Bare JSX text is preferred for plain prose.
• Use {...} only when JSX syntax requires it, such as backticks, braces, ``, or apostrophes inside the text.
• Keep XML attributes primitive and serializable.

Verification

• Run bun test in packages/jsx-md for renderer changes.
• Run bun run typecheck after export, type, or JSX runtime changes.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: theseus-run
• Source: theseus-run/theseus
• License: MIT
• Homepage: https://www.theseus.run

Install and usage instructions live in the source repository linked above.