weapp-tailwindcss-troubleshoot

weapp-tailwindcss-troubleshoot is a skill for Claude Code, Codex from sonofmagic/weapp-tailwindcss. It costs 130 tokens per session (646 once invoked), scanned A, original, MIT.

A troubleshooting guide for weapp-tailwindcss and its CLI when generated styles, class conversion, builds, or hot reload do not work as expected.

In plain words
What is it for?
Diagnose missing classes, broken HMR, wrong targets, component isolation, responsive styles, CLI output, and platform-specific WebView issues.
Why use it?
It provides an evidence-based way to locate whether the problem is in CSS generation, source scanning, conversion, the final output, or the running app.

Skill for Claude CodeCodex

About the project

weapp-tailwindcss is a build toolchain that generates and adapts Tailwind CSS for web pages, mini-programs, app webviews, React Native, and Lynx applications. It is for developers who want one Tailwind-based styling workflow to produce CSS and styles for multiple platforms.

sonofmagic/weapp-tailwindcss · 1,855 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-troubleshoot
Any agent
npx skills add sonofmagic/weapp-tailwindcss --skill weapp-tailwindcss-troubleshoot
Clone the repo
git clone --depth 1 https://github.com/sonofmagic/weapp-tailwindcss

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for weapp-tailwindcss-troubleshoot

README.md
[![agentmods](https://agentmods.dev/badge/skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-troubleshoot.svg)](https://agentmods.dev/skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-troubleshoot)
Your own site
<a href="https://agentmods.dev/skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-troubleshoot"><img src="https://agentmods.dev/badge/skills/sonofmagic/weapp-tailwindcss/weapp-tailwindcss-troubleshoot.svg" alt="Measured on agentmods" height="20"></a>
Per session 130 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 646 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00130 $0.00646
Opus 5 $0.00065 $0.00323
Sonnet 5 $0.00026 $0.00129
Haiku 4.5 $0.00013 $0.00065

Measured 5d ago against content hash 94593057f1bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

weapp-tailwindcss-troubleshoot scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/weapp-tailwindcss-troubleshoot/SKILL.md · 32 lines

What it actually says

weapp-tailwindcss troubleshoot

从生成、转译、产物到运行时逐层定位根因,避免用配置猜测掩盖症状。

诊断顺序

  1. 收集最小复现:框架、bundler、目标端、版本、命令、原始 class、期望与实际产物。
  2. 读取 references/symptom-matrix.md,先归类症状,再执行对应最短路径。
  3. 检查 Tailwind 入口是否为纯 CSS、是否实际进入构建图、cssEntries 是否为绝对路径、@source 是否覆盖源码。
  4. 检查是否存在第二个 Tailwind 生成器,或 H5/Web 被错误 disabled
  5. 分别验证 CSS 候选、模板/JS safe class、最终平台样式文件和真实页面;不要只看固定的 app.wxss 文件名。
  6. watch/HMR 问题要在同一进程连续新增 class,区分首次构建成功与增量图失效。
  7. CLI 问题先确认 web/weapp target、stdin/stdout、source map 与 watch 模式,不期待它改写模板或脚本。
  8. 只有根因确认后才修改配置,并补一条可重复的回归验证。

安全边界

  • JS 转译只接受 Tailwind 验证过的 classNameSet;未命中时修复扫描或刷新时序,不启用启发式全字符串转译。
  • space-* 先处理结构和组件虚拟节点,再最小扩展 cssOptions.cssChildCombinatorReplaceValue
  • App WebView 兼容必须记录 Android Chromium、iOS WebKit 或 Harmony/HBuilderX 环境,并以真实运行截图或日志为证据。
  • 不为排障临时加入 @tailwindcss/vite@tailwindcss/postcss
  • ReactLynx/Rspeedy 构建与 CSS encoder 问题转到 $weapp-tailwindcss-lynx

输出要求

先给根因层级和证据,再给最小修复、验证命令、预期结果和未解决时的下一条观测点。

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 32 lines · 130 tokens per session scan A 94593057f1bd

Subscribe to this mod's changes

weapp-tailwindcss-troubleshoot is a skill published in the GitHub repository sonofmagic/weapp-tailwindcss (1,855 stars, last pushed 3d ago), licensed MIT. It adds 130 tokens to every session and 646 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

Cypress v14 Component Testing

Component testing patterns with Cypress v14 including React, Vue, and Angular component mounting, custom mount commands, interaction testing, visual snapshots, and integration with Vite and Webpack bundlers.

PramodDutta/qaskills · 45 tokens

weapp-vite-best-practices

面向采用 weapp-vite 项目布局仓库或已安装 weapp-vite 依赖项目的工程化实践手册,覆盖 vite.config.ts 的 weapp 配置、内置 i18n、自动路由、routeRules/layout、buildScope、自动导入组件、分包、npm、六平台单目标构建、受管 TypeScript、HMR、sourcemap、prepare、MCP、Web runtime、lib mode、worker、AI skills,以及与 weapp-ide-cli 的命令治理边界。.

weapp-vite/weapp-vite · 134 tokens

native-to-weapp-vite-wevu-migration

面向原生微信、支付宝、抖音等小程序渐进迁移到 weapp-vite + 原生 或继续升级到 weapp-vite + wevu + Vue SFC 的结构化工作流,覆盖六平台单目标构建、原生扩展名保留、Web 联调边界、路线选择、工具链接入、SFC 试点、响应式升级与可回滚验证。.

weapp-vite/weapp-vite · 106 tokens

docs-and-website-sync

面向 weapp-vite monorepo 的文档、website 与公开 skills 同步工作流。适用于源码能力变化后同步配置、CLI、React/Wevu/Vue SFC、多平台、mpcore、README、packaged docs、脚手架 AGENTS.md、AI skills 元数据和触发回归入口。.

weapp-vite/weapp-vite · 79 tokens

weapp-vite-vue-sfc-best-practices

面向使用 weapp-vite 的小程序项目的 Vue SFC 实践手册,覆盖 script setup、纯模板 SFC、JSON 宏、definePageMeta/layout、defineModel、usingComponents、内置 i18n Behavior、JSX/TSX script block、模板指令兼容、多平台 SFC、.weapp-vite 类型支持文件与受管 prepare 工作流。.

weapp-vite/weapp-vite · 107 tokens

release-and-changeset-best-practices

面向 weapp-vite monorepo 的 repoctl release、pnpm change intent 与 issue 交付工作流。适用于 weapp-vite、wevu、@weapp-vite/react、mpcore、模板、公开 skills 或 AI 合约变更,判断 change intent、create-weapp-vite 联动、跨平台验证,以及从 issue worktree 到中文 PR/CI 的交付闭环。.

weapp-vite/weapp-vite · 106 tokens