Find agent skills by outcome

- Prioritize code quality

maintainability

- Follow current

supported patterns and best practices; propose migrations when older or deprecated approaches are encountered.

- Sometimes you may need to take other steps that aren't explicitly requests (running tests

checking for type errors

- Deliver fixes that handle edge cases

include error handling

Coding & Debugging

- Always prioritize code quality

maintainability

Coding & Debugging

- When finishing a task or request

review everything from the lens of code quality

- Error Handling: When parsing weird syntax

fail gracefully. Do not crash the linter process.

- Break down PostCSS traversal logic into small

testable utility functions.

- Utility Usage: Before writing a helper function

check whether the standard library

- Custom Syntax Awareness: When a rule depends on syntax that does not exist in plain CSS

scope it carefully and document the expected `customSyntax` or file context.

3. Edge cases (nested rules

comments

- Fixers: Only mark a rule as `meta.fixable = true` when the fix is deterministic and safe across supported syntaxes. If a fix is risky

report only.

- Use built-in TypeScript utility types first

and use installed utility-type libraries only when they clearly improve intent and match repository conventions.

- Performance First: Stylelint rules run on every save and often across large generated stylesheets. Avoid repeated whole-root rescans

repeated reparsing of selector/value strings

- AST Traversal: Use the narrowest viable PostCSS walk (`walkDecls`

`walkRules`

- `dist/`

coverage outputs

- If the repository syncs Node version files

peer dependency ranges

- If your change touches one of those surfaces

think beyond only unit tests.

- Beyond ESLint and TypeScript

many plugin repos also enforce:

- In repositories like this one

sync/validation flows may include:

- In repositories like this template

that often includes:

- Before changing a config file

check whether there is already a matching script

- When changing package exports

entrypoints

## Repository Tooling

Quality Gates