Improve a Front-End Checklist Rule
This skill helps you review and improve the quality of rule MDX files in the Front-End Checklist project. Use it to fix stub content, write better AI prompts, and enrich rules so they score well against the quality rubric.
Quality Dimensions
Every rule is scored across these dimensions (see references/scoring-rubric.md for full details):
| Dimension | Max | What "good" looks like |
|---|---|---|
prompts.check | 10 | Specific audit instruction, not generic |
prompts.fix | 10 | Actionable fix steps with CSS/HTML/JS specifics |
prompts.explain | 10 | Explains the why, not just restates the title |
tldr | 5 | 3+ concise bullets, each a standalone takeaway |
whyItMatters | 5 | 1–2 sentences, concrete user impact |
aiContext | 5 | "Applies to…" — when should an agent use this? |
relatedRules | 5 | 2+ slug + reason pairs |
codeExamples | 10 | 3+ ✅/❌ annotated blocks in the body |
bodyDepth | 10 | 300+ words, not a stub |
resources | 5 | External links (MDN, WCAG, articles) |
prompts.codeReview | 5 | Code review workflow prompt (optional) |
**Base score: 100 with addi…