Use this skill when the task is to adopt the slop-refinery skill set and the slop-refinery/eslint-plugin plugin surface in a TypeScript repository or fix an existing setup.
Goal
Make the target repo work with:
recommendedConfigformatConfig- Prettier
format,lint, andtypecheck- the
slop-refinery-quick-checksskill
The TypeScript templates in references/templates/typescript/ are merge targets, not blind replacements.
Workaround for the current skills dotfile-copy bug:
references/templates/typescript/prettierrcmust be written into the target repo as.prettierrc.- This is a temporary workaround for vercel-labs/skills#869.
Workflow
- Read
references/templates/typescript/. - Inspect the target repo:
- package.json - lockfile and package manager - current ESLint config - current Prettier config - current scripts - whether the repo uses AGENTS.md or CLAUDE.md for agent instructions
- Merge the templates into the repo. Do not blindly replace unrelated conventions.
- Write references/templates/typescript/prettierrc to the target repo as .prettierrc.
- Ensure the repo has the dev dependencies specified in
references/templates/typescript/package.json.
- Merge those dev dependencies into the target repo instead of dropping unrelated existing dependencies.
- Ensure
slop-refinery-quick-checksis installed. If it is missing, install it with:
npx skills add HOWMZofficial/slop-refinery --skill slop-refinery-quick-checks -y- Ensure the ESLint config imports
recommendedConfig.
- Do not turn off, ignore, override, or weaken any rules from recommendedConfig. - Apply recommendedConfig as broadly as possible. - If the repo has no existing ESLint file-pattern scoping, use the broadest applicable JS/TS file set. - If the repo already applies ESLint to JS/TS source files, apply recommendedConfig to those same file families as well.
- Ensure the format config imports
formatConfig. - Ensure the repo has:
- typecheck - format - lint - agent instructions in the repo's existing instruction file: use AGENTS.md when present otherwise, if CLAUDE.md exists, merge the guidance there instead of creating AGENTS.md
- Install dependencies.
- Run
slop-refinery-quick-checksand fix any issues it surfaces.
- Expect validation to fail during setup. That is normal. - It is common for setup to surface many linting errors at first. - Fix the code or setup until validation passes. - Do not disable rules, narrow rule scope, or weaken recommendedConfig to get to green.
If setup changes are required while fixing a problem, run slop-refinery-quick-checks again until everything is clean.
Guardrails
- Prefer merging over replacing.
- Prefer the repo's existing agent-instructions file. If the repo is using
CLAUDE.md, update that file instead of adding a secondAGENTS.md. - Do not turn off, ignore, or modify any rules from
recommendedConfigduring setup. - Do not narrow the scope of
recommendedConfigunless the repo already has a broader established ESLint scope you are merging into. - Apply
recommendedConfigto the broadest reasonable JS/TS file set the repo supports. - Expect setup to surface validation failures, often many of them.
- Treat those failures as work to fix, not as a reason to disable or weaken rules.
- Do not invent a placeholder
testscript. - Do not leave the repo partially configured.