Will this break my existing tests?

The skill includes a validation step that runs type-checking and tests to ensure the refactor hasn't introduced regressions or broken existing functionality.

Does this skill handle NodeNext extensions?

Yes, it follows best practices for NodeNext by using explicit .js extensions in TypeScript imports when updating file paths.

What is a boundary violation in this context?

A boundary violation occurs when client-side code imports server-side logic, classes, or utilities that contain implementation details which shouldn't be bundled in the browser.

How does this affect client code generation?

It updates generation templates to ensure the output code references the shared model directory instead of incorrectly inferring types from server class modules.

Which symbols are safe to move to the models directory?

Only pure contracts such as interfaces, type aliases, and enums used as data transfer objects (DTOs) should be moved. Implementation code like decorated classes or DB utilities should remain local.

Shared Model Refactor

Name: Shared Model Refactor
Author: jts599

byjts599

0•

API開発

Refactors TypeScript contracts into shared model directories to eliminate architectural boundary violations between client and server code.

The Shared Model Refactor skill automates the cleanup of TypeScript projects by identifying and isolating shared contracts like DTOs, interfaces, and enums into a centralized models directory. It helps developers maintain a clean separation of concerns by preventing the frontend from importing backend implementation files, ensuring that only type-safe, side-effect-free contracts cross the client-server boundary. This is particularly useful for projects using frameworks like QuickApp where maintaining lean dependencies and efficient client generation is critical for performance and maintainability.

主な機能

01Validates architectural integrity through automated type-checking and build verification

02Centralizes DTOs and view-data models into feature-based model files

03Updates client generation templates to rely on shared models instead of server classes

04Identifies cross-boundary import violations using automated regex searching

050 GitHub stars

06Extracts pure TypeScript contracts such as interfaces, enums, and types

ユースケース

01Fixing bundling errors caused by client code accidentally importing server-side dependencies

02Separating backend logic from frontend-accessible DTOs in full-stack TypeScript applications

03Standardizing API contracts to ensure consistency across generated client runtimes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jts599/quickapp shared-model-refactor

For use in Claude.ai and ChatGPT

主な機能

01Validates architectural integrity through automated type-checking and build verification

02Centralizes DTOs and view-data models into feature-based model files

03Updates client generation templates to rely on shared models instead of server classes

04Identifies cross-boundary import violations using automated regex searching

050 GitHub stars

06Extracts pure TypeScript contracts such as interfaces, enums, and types

ユースケース

01Fixing bundling errors caused by client code accidentally importing server-side dependencies

02Separating backend logic from frontend-accessible DTOs in full-stack TypeScript applications

03Standardizing API contracts to ensure consistency across generated client runtimes