dotnet-stylelint

Stylelint for Stylesheets in .NET Repositories

Trigger On

• the repo has stylelint.config.*, .stylelintrc*, or CSS and SCSS assets under frontend folders
• the user asks for CSS linting, duplicate style cleanup, naming convention enforcement, or design-system guardrails
• the repo needs a stylesheet gate beyond formatting alone

Do Not Use For

• JavaScript or TypeScript ownership; route that to dotnet-eslint or dotnet-biome
• runtime accessibility, performance, SEO, or header checks; route that to dotnet-webhint
• repos that intentionally use only Biome for CSS linting and do not want a separate stylesheet linter

Inputs

• the nearest AGENTS.md
• package.json
• stylelint.config.* or .stylelintrc*
• the stylesheet file types in scope: CSS, SCSS, Less, embedded styles, or generated output

Workflow

1. Confirm what Stylelint should own:
   • plain CSS only
   • CSS plus SCSS
   • embedded styles in HTML, Markdown, or framework files
2. Prefer repo-local installation and checked-in config.
3. Start from a known shared config such as stylelint-config-standard, then add syntax-specific packages only when the repo truly needs them.
4. Add repeatable scripts to package.json, for example:
   • stylelint "**/*.{css,scss}"
   • stylelint "**/*.{css,scss}" --fix
5. Keep ignore patterns explicit so build output, vendored assets, and generated CSS do not pollute the signal.
6. Treat autofix as controlled cleanup:
   • run on a bounded scope first
   • inspect the diff
   • rerun the frontend build if the repo compiles styles
7. Use Stylelint for semantic CSS and selector policy, not as a replacement for site-level audits.

Bootstrap When Missing

1. Detect current state:
   • rg --files -g 'package.json' -g 'stylelint.config.*' -g '.stylelintrc*'
   • rg -n '"stylelint"|"stylelint-config-" --glob 'package.json' .
2. Prefer a repo-local install:
   • npm install --save-dev stylelint stylelint-config-standard
3. Add syntax packages only when the repo needs them for SCSS or embedded styles.
4. Create or refine stylelint.config.js, stylelint.config.mjs, or the existing config format.
5. Add repeatable commands to AGENTS.md and package.json, then verify with:
   • npx stylelint "**/*.{css,scss}"
   • npx stylelint "**/*.{css,scss}" --fix
6. Return status: configured if Stylelint is now wired and repeatable, or status: improved if the existing baseline was tightened.
7. Return status: not_applicable only when another documented tool already owns stylesheet linting and migration is not requested.