agentsclimarketplace

Maintainable typescript

Skill MiguelsPizza/skills/skills/maintainable-typescript

Guides maintainability-first cleanup, refactoring, and review in strict TypeScript repos and monorepos. Use when improving code health, deleting dead code, reducing duplication, or enforcing boundaries.From its SKILL.md

Install
npx -y skills add MiguelsPizza/skills --skill maintainable-typescript

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.0 KB, as published. Nobody here has run it

Maintainable TypeScript

Use this skill when the project needs maintainability doctrine, not just local code changes.

Load Order

Do not read the whole skill directory by default.

  1. Read this file first.
  2. Load only files that match the task.
  3. If the repo matches the house stack, read stack/start-here.md.
  4. Treat doctrine/, stack/, prompts/, scripts/, and assets/tooling-templates/ as references, not required context.

Companion Skills

Use the fallow skill for Fallow config, commands, JSON output, fixes, CI gates, and result interpretation. If missing:

npx skills add https://github.com/fallow-rs/fallow/tree/main/npm/fallow/skills/fallow --skill fallow

Task Router

Audit workflow

For cleanup or review:

skill_dir="<path-to-this-skill>"
bash "$skill_dir/scripts/audit-typescript-repo.sh" .

Treat audit output as signal, not authority. Check real usage before deleting API surface or collapsing a pattern.

If the target repo is Vite+, use vp for the normal toolchain entrypoint: vp lint, vp test, vp fmt, vp pack, vp add, and vp dlx.

Defaults

  • Structure is expensive; preserve contracts, tests, and invariants.
  • Prefer deletion over shims, real owners over fake layers, and stable subsystem files over helper forests.
  • Resolve uncertainty into contracts, not adapters, defaults, optionals, spreads, or catches.
  • Prefer derived types/schemas, durable integration tests, external-boundary mocks only, and assertions on observable outcomes.
  • Prefer Fallow for dead code, duplication, dependency hygiene, health, cycles, and dependency boundaries.
  • Leave the codebase more coherent now.

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.