Agent skill

X Markdown

by kqcoxn in kqcoxn/MaaPipelineEditor

当任务涉及 @ant-design/x-markdown 的 Markdown 渲染、流式输出、自定义组件映射、插件、主题或聊天富内容展示时使用。

MITAuto-check passedDocuments & Office

Install X Markdown

skills CLI
$ npx skills add kqcoxn/MaaPipelineEditor --skill x-markdown -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kqcoxn/MaaPipelineEditor x-markdown --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kqcoxn/MaaPipelineEditor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ant-design-x/skills/x-markdown .claude/skills/x-markdown && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-markdown
GitHub stars
408
Token cost
~862 tokens
SKILL.md length
166 words
Files
5
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

当任务涉及 @ant-design/x-markdown 的 Markdown 渲染、流式输出、自定义组件映射、插件、主题或聊天富内容展示时使用。

  • Works in 4 steps: 先看 CORE.md,先让基础渲染跑通。 → 只有在内容是分块到达时,才继续看 STREAMING.md。 → 只有在需要自定义标签、插件、主题时,才继续看 EXTENSIONS.md。 → …
  • Tasks that involve Markdown
  • SKILL.md covers 目录导航, 最小使用示例, 边界规则 and 官方文档
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

X Markdown is an agent skill from kqcoxn/MaaPipelineEditor. 当任务涉及 @ant-design/x-markdown 的 Markdown 渲染、流式输出、自定义组件映射、插件、主题或聊天富内容展示时使用。

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `reference/API.md`, `reference/CORE.md` and `reference/EXTENSIONS.md`).

It sits in Documents & Office, covering Markdown. It works with Ant Design. The repository describes itself as: ✨ 可视化构建 MaaFramework Pipeline 的下一代工作流 审阅&编辑&调试 工具,你的工程师牛牛! ✨. The licence is MIT.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/x-markdown”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 先看 CORE.md,先让基础渲染跑通。
  2. 只有在内容是分块到达时,才继续看 STREAMING.md。
  3. 只有在需要自定义标签、插件、主题时,才继续看 EXTENSIONS.md。
  4. 属性名与默认值以 API.md 为准,不要凭记忆猜。

What it can do on your machine

Read from SKILL.md and the folder at commit bff320d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Markdown loads about 862 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 166 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~862

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kqcoxn/MaaPipelineEditor at commit bff320d, republished under its MIT licence (© kqcoxn). 166 words, ~862 tokens.

Download SKILL.mdSave it as .claude/skills/x-markdown/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
x-markdown
description
当任务涉及 @ant-design/x-markdown 的 Markdown 渲染、流式输出、自定义组件映射、插件、主题或聊天富内容展示时使用。
version
2.9.0

🎯 技能定位

本技能专注解决一个问题:如何用 @ant-design/x-markdown 正确、稳定地渲染 Markdown 内容。

覆盖范围包括:

  • 基础渲染与包职责边界
  • LLM 流式输出与不完整语法处理
  • 自定义组件映射与聊天富内容渲染
  • 插件、主题与安全默认配置

目录导航

📦 包职责边界

层级包名职责
UI层@ant-design/x聊天 UI、Bubble、Sender、交互组件
数据层@ant-design/x-sdkProvider、请求、流式数据流、状态管理
渲染层@ant-design/x-markdownMarkdown 解析、流式渲染、插件、主题、自定义渲染

⚠️ x-markdown 不是聊天状态管理工具。它负责把已有消息内容渲染出来,不负责请求和消息流本身。

🚀 快速决策指南

当你需要...优先阅读典型结果
用最小配置渲染 MarkdownCORE.md用 XMarkdown 渲染基础内容
渲染 LLM 流式输出STREAMING.md正确处理 hasNextChunk、占位符、尾部指示器
把标签映射到业务组件EXTENSIONS.md为自定义标签、代码块、富内容组件建立稳定映射
增加插件或主题定制EXTENSIONS.md完成插件导入、主题类名接入、最小 CSS 覆盖
查看属性细节和默认值API.md获取 XMarkdown 与 streaming 的完整属性表

🛠 推荐工作流

  1. 先看 CORE.md,先让基础渲染跑通。
  2. 只有在内容是分块到达时,才继续看 STREAMING.md。
  3. 只有在需要自定义标签、插件、主题时,才继续看 EXTENSIONS.md。
  4. 属性名与默认值以 API.md 为准,不要凭记忆猜。

最小使用示例

tsx
import { XMarkdown } from '@ant-design/x-markdown';

export default () => <XMarkdown content="# Hello" />;

🚨 开发规则

  • components 映射尽量保持稳定,不要在每次渲染时创建新的内联组件对象。
  • 最后一块内容必须设置 streaming.hasNextChunk = false,否则不完整占位内容不会被刷新成最终结果。
  • 谨慎处理原始 HTML。如果只想保留文本展示,优先使用 escapeRawHtml。
  • 如果必须渲染 HTML,请显式审查 dompurifyConfig,不要依赖模糊默认行为。
  • 主题覆盖尽量最小化。先继承 x-markdown-light 或 x-markdown-dark,只改必要变量。
  • 如果自定义组件依赖完整语法,再在 streamStatus === 'done' 时执行昂贵逻辑。

🤝 技能协作

场景推荐技能组合原因
聊天中的富文本回答x-chat-provider → x-request → use-x-chat → x-markdown前三者负责数据流,x-markdown 负责最终内容渲染
内置 Provider + Markdown 回复x-request → use-x-chat → x-markdown请求配置与渲染职责分离
独立的 Markdown 页面或文档视图x-markdown不需要聊天状态管理

边界规则

  • 适配接口格式,用 x-chat-provider
  • 配置传输、认证、重试、流分隔,用 x-request
  • 管理 React 聊天状态,用 use-x-chat
  • 处理 Markdown 解析、流式恢复和富组件渲染,用 x-markdown

🔗 参考资源

  • CORE.md - 包职责、安装与起步、安全默认值、常见渲染模式
  • STREAMING.md - 分块渲染、不完整语法恢复、loading/done 行为
  • EXTENSIONS.md - 组件映射、插件、主题、自定义标签建议
  • API.md - 从官方 x-markdown 文档生成的 API 参考

官方文档

© kqcoxn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in .agents/skills/ant-design-x/skills/x-markdown of kqcoxn/MaaPipelineEditor.

  • SKILL.md
  • reference/API.md
  • reference/CORE.md
  • reference/EXTENSIONS.md
  • reference/STREAMING.md

Open the folder on GitHubat commit bff320d

Compare with similar skills

X Markdown next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Markdown compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Markdown this skillkqcoxn/MaaPipelineEditor408—~862Automated safety check: PassMIT
Component Markdown Editorantdigital-ai/agentic-ui224—~292Automated safety check: PassMIT
Markdown Syntax Guideantdigital-ai/agentic-ui224—~3.1kAutomated safety check: PassMIT
Using Docs Kitlobehub/lobe-ui2.2k—~2.8kAutomated safety check: PassMIT
Component Markdown Input Fieldantdigital-ai/agentic-ui224—~235Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Component Markdown Editor

    antdigital-ai/agentic-ui

    Develop MarkdownEditor and BaseMarkdownEditor in @ant-design/agentic-ui for rich text and streaming markdown.

    224 GitHub stars~292 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Markdown Syntax Guide

    antdigital-ai/agentic-ui

    指导用户使用 @ant-design/agentic-ui 的 Markdown Editor / Renderer 扩展语法。图表场景优先使用内置 chart(HTML 注释 chartType + 表格),只有当内置 chartType 都不能表达诉求时才回退 Mermaid。Triggers on keywords like 表格, 视频, 图表, 卡片, 提示块, 流程图, 语法…

    224 GitHub stars~3.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Using Docs Kit

    lobehub/lobe-ui

    Set up and author a documentation site with @lobehub/docs-kit (the lobedocs CLI, React Router + Vite static docs used by ui.lobehub.com).

    2.2k GitHub stars~2.8k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Component Markdown Input Field

    antdigital-ai/agentic-ui

    Develop MarkdownInputField and attachments, voice, send actions in @ant-design/agentic-ui.

    224 GitHub stars~235 tokensUpdated today
    Backend & APIsAuto-check passed
  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes

More from kqcoxn/MaaPipelineEditor

All 12 skills in this repo
  • Ant Design

    kqcoxn/MaaPipelineEditor

    Decision guide for antd 6.x, Ant Design Pro 5/ProComponents, Ant Design X v2, and the offline @ant-design/cli.

    408 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Maafw

    kqcoxn/MaaPipelineEditor

    MaaFramework 开发与集成指南。当任务涉及 MaaFramework 项目结构、Pipeline 协议、ProjectInterface V2 协议、自定义识别/动作(Custom/Agent)、Python/NodeJS/CSharp 等语言 Binding 集成、控制器配置、回调协议或运行时行为时使用。

    408 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Mpe Background Art

    kqcoxn/MaaPipelineEditor

    为 MPE 桌面端策划、生成或修改版本主题背景图,复用机械动力牛牛与章鱼猫的定稿形象;也用于维护这两个角色的设定与三视图。不用于普通界面样式修改或无关插画。

    408 GitHub stars~410 tokensUpdated today
    Auto-check passed
  • Use X Chat

    kqcoxn/MaaPipelineEditor

    专注讲解如何使用 useXChat Hook,包括自定义 Provider 的集成、消息管理、错误处理、多会话管理等. An agent skill from kqcoxn/MaaPipelineEditor.

    408 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • X Card

    kqcoxn/MaaPipelineEditor

    当需要用 @ant-design/x-card 让 AI Agent 动态渲染富交互 UI 时使用——涵盖 XCard.Box、XCard.Card、A2UI v0.9 命令、数据绑定、Catalog、Actions 和流式渲染模式。

    408 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • X Chat Provider

    kqcoxn/MaaPipelineEditor

    专注于自定义 Chat Provider 的实现,帮助将任意流式接口适配为 Ant Design X 标准格式. An agent skill from kqcoxn/MaaPipelineEditor.

    408 GitHub stars~3.1k tokensUpdated today
    Auto-check passed

Works with

Questions about X Markdown

What does X Markdown do?

当任务涉及 @ant-design/x-markdown 的 Markdown 渲染、流式输出、自定义组件映射、插件、主题或聊天富内容展示时使用。. X Markdown is an agent skill from kqcoxn/MaaPipelineEditor.

When should I use X Markdown?

X Markdown fits situations like: tasks that involve Markdown.

How do I install X Markdown in Claude Code?

Run `npx skills add kqcoxn/MaaPipelineEditor --skill x-markdown -a claude-code`. Or copy the skill folder (.agents/skills/ant-design-x/skills/x-markdown in kqcoxn/MaaPipelineEditor) into .claude/skills/x-markdown in your project. Claude Code loads it when a task matches its description.

How do I install X Markdown in Codex?

Run `npx skills add kqcoxn/MaaPipelineEditor --skill x-markdown -a codex`. Or copy the skill folder (.agents/skills/ant-design-x/skills/x-markdown in kqcoxn/MaaPipelineEditor) into .agents/skills/x-markdown in your project. Codex loads it when a task matches its description.

Can I use X Markdown in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kqcoxn/MaaPipelineEditor --skill x-markdown -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-markdown, .gemini/skills/x-markdown, .github/skills/x-markdown and .opencode/skills/x-markdown in your project.

What does X Markdown need to run?

SKILL.md names no scripts, command-line tools or credentials: X Markdown is instructions for the agent only.

Does X Markdown access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is X Markdown safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does X Markdown use?

X Markdown is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Markdown use?

About 862 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to X Markdown?

Skills that share tags, products or a category with X Markdown: Component Markdown Editor (antdigital-ai/agentic-ui, 224 stars), Markdown Syntax Guide (antdigital-ai/agentic-ui, 224 stars), Using Docs Kit (lobehub/lobe-ui, 2.2k stars) and Component Markdown Input Field (antdigital-ai/agentic-ui, 224 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Markdown?

kqcoxn (a GitHub user) maintains it in kqcoxn/MaaPipelineEditor, which has 408 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: kqcoxn/MaaPipelineEditor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.