0
0
Fork 0
mirror of https://github.com/discourse/discourse.git synced 2026-08-05 21:16:17 +08:00
discourse/.skills/discourse-writing-html-css
sam-saffron-jarvis 49f3b2e174
DEV: Add CSS repair guidance to HTML/CSS skill (#41074)
## What

Adds repair-oriented guidance to the existing
`discourse-writing-html-css` skill.

This extends the skill from authoring new CSS into safely modifying
existing CSS, covering:

- selector scoping instead of specificity escalation
- deleting stale CSS/imports before adding overrides
- consolidating device-specific CSS into `common/` with viewport mixins
- overflow containment patterns (`min-width: 0`, `minmax(0, 1fr)`,
`@include ellipsis`, etc.)
- iOS/container scroll guidance
- FormKit/select-kit token/API repairs
- foundation-wide audit and verification checklist

Also adds `references/css-repair.md` as the deeper companion reference.

## Why

Recent CSS repair work shows the same pattern repeatedly: delete stale
CSS, scope what remains, use shared tokens/FormKit APIs, and fix layout
by correcting containment rather than layering more overrides. This
documents that workflow directly in the skill.

## Testing

```text
bin/lint .skills/discourse-writing-html-css/SKILL.md .skills/discourse-writing-html-css/references/css-repair.md
No files to lint, exiting.
[bin/lint] All lints passed
```

---------

Co-authored-by: chapoi <101828855+chapoi@users.noreply.github.com>
2026-06-29 09:07:25 +10:00
..
references
SKILL.md