shared-model-refactor — community shared-model-refactor, QuickApp, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for Code Refactoring Agents needing to minimize overhead in React applications A framework for making React Apps with minimal overhead

jts599 jts599
[0]
[0]
Updated: 2/22/2026

Agent Capability Analysis

The shared-model-refactor skill by jts599 is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for Code Refactoring Agents needing to minimize overhead in React applications

Core Value

Empowers agents to refactor code for shared contracts, utilizing `sampleImplementation/models/` and optimizing imports for server and client, leveraging React and rg for efficient boundary violation identification and movable symbol detection

↓ Capabilities Granted for shared-model-refactor

Refactoring React codebases for minimal overhead
Identifying boundary violations in server and client imports
Migrating pure contracts to shared models

! Prerequisites & Limits

  • Requires React application setup
  • Limited to JavaScript and React ecosystem
  • Needs rg for efficient code searching
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

shared-model-refactor

Install shared-model-refactor, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Shared Model Refactor

Refactor code so server and client both import shared contracts from sampleImplementation/models/ instead of importing each other.

Workflow

  1. Find boundary violations.
  • Run:
    • rg -n "from ['\"].*server/|from ['\"].*client/" sampleImplementation src test -S
  • Identify client imports from sampleImplementation/server/* and server imports from sampleImplementation/client/*.
  1. Identify movable symbols.
  • Move only pure contracts:
    • interfaces
    • type aliases
    • enums/constants used as DTO/schema contracts
  • Do not move implementation/runtime code:
    • decorated classes
    • business logic
    • DB/network utilities
  1. Create model files.
  • Place extracted contracts in sampleImplementation/models/.
  • Use feature-based files (for example sampleImplementation/models/sampleView.ts).
  • Keep files side-effect free.
  1. Update imports.
  • Update server and client to import contracts from sampleImplementation/models/*.
  • For NodeNext, use explicit .js extensions in TS imports.
  • Prefer import type for type-only imports.
  1. Update client generation templates/runtime.
  • Ensure generated client code imports contracts from models/, not server class modules.
  • If generator currently infers types via server class imports, switch generation to explicit model imports per controller.
  1. Regenerate generated client files.
  • Run generation command(s) after template changes.
  1. Validate.
  • Run:
    • npm run typecheck
    • npm test
    • cd sampleImplementation && npm run build
  • Confirm no client file imports from sampleImplementation/server/*.

File Organization Rules

  • sampleImplementation/models/ is the only shared contract boundary.
  • Server code may import from models/ and src/.
  • Client code may import from models/ and src/client runtime APIs.
  • Client code must not import from sampleImplementation/server/.

Refactor Heuristics

  • Keep model names aligned with domain language.
  • Split large contract files by feature, not by type-kind.
  • Do not duplicate contracts in both server and client.
  • If a contract is only used on one side, keep it local.

Acceptance Criteria

  • Zero cross-boundary implementation imports between server/ and client/.
  • Shared DTO/view-data/method contracts live under sampleImplementation/models/.
  • Generated client output compiles and no longer depends on server class imports.
  • Full typecheck/tests/build pass.

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is shared-model-refactor?

Perfect for Code Refactoring Agents needing to minimize overhead in React applications A framework for making React Apps with minimal overhead

How do I install shared-model-refactor?

Run the command: npx killer-skills add jts599/QuickApp/shared-model-refactor. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for shared-model-refactor?

Key use cases include: Refactoring React codebases for minimal overhead, Identifying boundary violations in server and client imports, Migrating pure contracts to shared models.

Which IDEs are compatible with shared-model-refactor?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for shared-model-refactor?

Requires React application setup. Limited to JavaScript and React ecosystem. Needs rg for efficient code searching.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add jts599/QuickApp/shared-model-refactor. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use shared-model-refactor immediately in the current project.

Related Skills

Looking for an alternative to shared-model-refactor or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI