mkdocs-shadcn 主题 Markdown 排版与项目编排。当用户需要编写或修改 mkdocs-shadcn 主题的文档、配置 mkdocs.yml、或询问排版语法时，必须使用此技能。
mkdocs-shadcn 主题 Markdown 排版与项目编排。当用户需要编写或修改 mkdocs-shadcn 主题的文档、配置 mkdocs.yml、或询问排版语法时，必须使用此技能。
npx skills add https://github.com/jspi-fu/customized-skills --skill mkdocs-shadcn复制此命令并粘贴到 Claude Code 中以安装该技能
| name | mkdocs-shadcn |
| description | mkdocs-shadcn 主题 Markdown 排版与项目编排。当用户需要编写或修改 mkdocs-shadcn 主题的文档、配置 mkdocs.yml、或询问排版语法时，必须使用此技能。 |
运行配置检查脚本：
python <mkdocs-shadcn-path>/scripts/check_config.py <项目目录> [--apply]
脚本会自动检查并补充：
theme.name 是否为 shadcnplugins 是否包含必要插件markdown_extensions 是否包含推荐的扩展nav 导航配置site_name 站点名称如需自动应用修复，添加 --apply 参数。
根据内容特征选择合适语法，进行排版：
| 内容特征 | 选择语法 | 参考文档 |
|---|---|---|
| 内容较长，非必需阅读 | /// details | syntax-guide.md |
| 问答形式的 FAQ | /// details | ❓ 问题 | syntax-guide.md |
| 多平台/互斥选项 | /// tab | syntax-guide.md |
| 技巧、建议 | !!! tip | syntax-guide.md |
| 警告、风险 | !!! warning/danger | syntax-guide.md |
| 补充说明 | !!! note/info | syntax-guide.md |
详细语法和示例参考 syntax-guide.md 和 examples.md。
排版内容完成后，必须运行格式化脚本：
python <mkdocs-shadcn-path>/scripts/format.py <文件或目录路径>
脚本自动处理：
---，H3 上方 ---，H2 后第一个 H3 除外）<img ...>
assets/ 路径转为 /assets 绝对路径）新建页面时，使用终端命令复制 assets/page-template.md 作为起点。
项目初始化时，参考 assets/mkdocs-template.yml 创建配置文件。
内容是否需要折叠？
├── 是 → /// details
│ └── FAQ 形式？→ 标题用 ❓ 开头
│
内容是否有多个互斥选项？
├── 是 → /// tab
│ └── 按平台/方式/工具分类
│
内容是否需要突出强调？
├── 是 → !!! tip/note/warning/danger
│
└── 默认 → 直接展示
为用户生成思想汇报文档。当用户要求写思想汇报、入党积极分子季度汇报、预备党员思想汇报或类似政治汇报材料时触发使用。用户提及"思想汇报"、"季度汇报"、"入党积极分子汇报"或类似场景时，必须调用此技能。
指导 AI 生成符合 EdgeOne Pages 平台规范的代码，支持 SSG/SSR/ISR、Edge Functions 和 Node Functions。当用户需要创建或改造部署到 EdgeOne Pages 的 Web 项目、询问 EdgeOne 开发规范、或需要选择 Edge/Node Functions 时触发此技能。