ss-lint

Featured

Quick automated lint — detects common design system violations in seconds

Web & Frontend 850 stars 75 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 95/100

Stars 20%
98
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Design Lint (Quick Check) Read `PRODUCT-PRINCIPLES.md`, the selected output grammar, `ADAPTERS.md`, and `STYLESEED.md` before classifying a match. Lint detects deterministic drift; it must not flag an exact grammar/profile/adapter contract as a violation or let an arbitrary lock value create an exception. ## When NOT to use - For deeper review of design judgment (composition, hierarchy, rhythm) → use `/ss-review` - For accessibility specifically → use `/ss-a11y` - For Nielsen UX heuristics → use `/ss-audit` - For applying refactors — this only flags violations; use `/ss-review` to fix Target: **$ARGUMENTS** ## What This Does Fast, grep-based scan for common design violations. Runs in seconds (unlike /ss-review which is a deep manual audit). Run this after every file change. ## Checks ### 1. Hardcoded Colors Search for hex colors in className strings that should be semantic tokens: ```bash grep -n '#[0-9a-fA-F]\{3,8\}' [file] | grep -v 'theme.css\|tokens\|\.json' ``` **Violation:** `text-[#3C3C3C]`, `bg-[#3182F6]` **Fix:** `text-text-primary`, `bg-brand` ### 2. Raw Pixel Values in Tailwind ```bash grep -n 'p-\[.*px\]\|m-\[.*px\]\|gap-\[.*px\]' [file] ``` **Violation:** `p-[24px]`, `gap-[12px]` **Fix:** `p-6`, `gap-3` ### 3. Old Width/Height Syntax ```bash grep -n 'w-[0-9] h-[0-9]\|w-\[.*\] h-\[' [file] ``` **Violation:** `w-4 h-4` **Fix:** `size-4` ### 4. Physical Properties (LTR-only) ```bash grep -n ' ml-\| mr-\| pl-\| pr-' [file] ``` **Violation:** `ml-2`, `mr-...

Details

Author
bitjaru
Repository
bitjaru/styleseed
Created
3 months ago
Last Updated
4 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category