fix-file-encoding

Community

Detect and fix garbled file encodings to UTF-8

AuthorCloudyWing
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Detects files that appear as garbled text due to legacy encodings (Big5/ANSI) or incorrect BOM usage and converts them to the appropriate UTF-8 variant so source files and text assets display correctly across tools and platforms.

Core Features & Use Cases

  • File discovery and confirmation: List matching files by path or glob and let the user confirm the set to process.
  • Extension-driven target encoding: Map file extensions and project framework (e.g., .ps1, .csv, .cs, .vb, .aspx, .master, .cshtml) to a target encoding policy including UTF-8 with or without BOM.
  • Heuristic detection and conversion: Detect encoding via byte-marker checks and Big5 fallback, skip binary files, convert using PowerShell with correct BOM handling, and present a conversion summary for review.
  • Use Case: Fix mixed-encoding legacy repositories where some scripts require BOM while most source files should be UTF-8 without BOM.

Quick Start

Run the fix-file-encoding skill on the repository by saying /fix-file-encoding path/to/files_or_glob and confirm the listed files when prompted.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: fix-file-encoding
Download link: https://github.com/CloudyWing/ai-dotfiles/archive/main.zip#fix-file-encoding

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.