Why is the 'one import per line' rule better than single-line imports?

Single-line imports cause 'noisy' diffs where adding one new item modifies the entire line. One-per-line formatting ensures that adding a new item only creates one new line, keeping the rest of the file's history intact.

Can I automate these rules with my existing IDE tools?

Absolutely. This skill is designed to complement tools like eslint-plugin-simple-import-sort and Prettier, providing the logic for Claude to follow those rules during code generation.

Does this work with JavaScript projects as well?

Yes, while specifically optimized for TypeScript types, these import formatting and ordering rules apply equally to standard JavaScript and ESM modules.

How does this skill specifically reduce merge conflicts?

By placing each import on its own line and sorting them alphabetically at predictable positions, Git can easily merge additions from different sources without overlapping line-level collisions.

TypeScript Merge-Friendly Imports

Name: TypeScript Merge-Friendly Imports
Author: jpoutrin

byjpoutrin

•

Developer Tools

Enforces standardized TypeScript import formatting to minimize merge conflicts and improve code readability in multi-agent environments.

This skill automates the organization of TypeScript imports by enforcing a strict one-import-per-line rule, alphabetical sorting, and logical grouping. By standardizing how modules are imported, it significantly reduces git merge conflicts during parallel development—whether you're working with a human team or multiple AI agents. It ensures consistency across your codebase by aligning with professional linting standards, making diffs cleaner and code reviews significantly more efficient.

Key Features

01Standardizes logical import grouping from Node.js built-ins to type-only imports

02Reduces git merge conflicts in parallel or multi-agent development workflows

03Enforces one-import-per-line formatting for multi-item modules

04Integrates seamlessly with ESLint and Prettier configurations

05Implements alphabetical sorting for groups and individual named imports

065 GitHub stars

Use Cases

01Managing large TypeScript projects where multiple developers commit to the same files

02Optimizing workflows for parallel AI agents or Claude Code to prevent branch divergence

03Standardizing legacy codebases with inconsistent and messy import blocks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge typescript-import-style

For use in Claude.ai and ChatGPT

Download Skill