If you're writing codemods with jscodeshift, this gives you 40 specific rules from Facebook/Meta organized by impact. It covers the stuff that actually matters: parser configuration to avoid silently breaking on TypeScript, AST traversal patterns that won't tank performance on large codebases, and how to preserve comments when transforming nodes. The priority system is helpful because parser config and traversal patterns are marked critical while composition patterns are low priority, which matches reality. Each rule links to detailed examples with impact metrics. Worth having loaded if you're doing any serious code migration work or debugging why your transform is mangling output.

skills.sh installs
416
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill jscodeshift --agent claude-code

Installs into .claude/skills of the current project.

Files

Facebook/Meta jscodeshift Best Practices

Comprehensive best practices guide for jscodeshift codemod development, designed for AI agents and LLMs. Contains 40 rules across 8 categories, prioritized by impact from critical (parser configuration, AST traversal) to incremental (advanced patterns). Each rule includes detailed explanations, real-world examples, and specific impact metrics.

When to Apply

Reference these guidelines when:

  • Writing new jscodeshift codemods for code migrations
  • Debugging transform failures or unexpected behavior
  • Optimizing codemod performance on large codebases
  • Reviewing codemod code for correctness
  • Testing codemods for edge cases and regressions

Rule Categories by Priority

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Documentation, Code Review & Quality, Debugging, Automation & Workflows
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1pproenca avatarexpo-react-native-coderpproenca/dot-skillsComprehensive Expo React Native feature development guide. This skill should be used when building mobile app screens, navigation, data fetching, authentication415skills.sh installs
2openfga avataropenfgaopenfga/agent-skillsOpenFGA authorization modeling best practices for defining types and relations, writing relationship tuples, deriving can_* permissions, applying type restricti412skills.sh installs
3jezweb avatarcloudflare-d1jezweb/claude-skillsBuild with D1 serverless SQLite database on Cloudflare's edge. Use when: creating databases, writing SQL migrations, querying D1 from Workers, handling relation408skills.sh installs
4nanmicoder avatarnews-extractornanmicoder/newscrawler新闻站点内容提取。支持 12 个平台:微信公众号、今日头条、网易新闻、搜狐新闻、腾讯新闻、BBC News、CNN News、Twitter/X、Lenny's Newsletter、Naver Blog、Detik News、Quora。当用户需要提取新闻内容、抓取公众号文章、爬取新闻、或获取新闻JSON/Markd408skills.sh installs
5secondsky avatarclaude-hook-writersecondsky/claude-skillsExpert guidance for writing secure, reliable, and performant Claude Code hooks - validates design decisions, enforces best practices, and prevents common pitfal408skills.sh installs
6davila7 avatargeopandasdavila7/claude-code-templatesPython library for working with geospatial vector data including shapefiles, GeoJSON, and GeoPackage files. Use when working with geographic data for spatial an407skills.sh installs