用途:用于 Claude Skills 展示网站的 Docusaurus 构建健康、MDX 校验与部署安全,在提交前拦截常见构建失败。
主要能力:提交前对 markdown/MDX 文件做校验;检测 Liquid 模板语法错误;校验 SkillHeader 组件 props;检查缺失的 hero 图片与 ZIP 文件;构建前链接校验与构建后健康报告;诊断 Docusaurus 构建失败。它针对五类反复出现的问题:示例中的 Liquid 语法、未转义的尖括号、错误的 SkillHeader props(应使用 fileName 而非 skillId)、缺失关键文件、缓存损坏。
使用方式:一次性安装钩子运行 npm run install-hooks。手动校验可运行 npm run validate:liquid、npm run validate:brackets、npm run validate:props、npm run validate:all。卡住时清理缓存:rm -rf .docusaurus build node_modules/.cache 后再 npm run build。提交前钩子会自动扫描代码块之外的 Liquid 双花括号、查找 <digit 模式、校验组件用法并检查必需文件,通常在 5 秒内完成。校验脚本位于 scripts/ 文件夹,包括 validate-liquid.js、validate-brackets.js、validate-skill-props.js。
适用场景:提交前校验、定位构建失败、检查链接与资源。限制:不适用于通用 DevOps、Kubernetes/云基础设施、运行时监控告警、数据库迁移与安全扫描。资料未提供具体价格、平台支持范围及更多安装细节。