Communitygithub.com

G1Joshi/Agent-Skills

Assistance experte en SWC couvrant la compilation JavaScript/TypeScript haute performance basée sur Rust, la configuration .swcrc, les tests Jest via @swc/jest, et la minification. Utilisez-le pour remplacer Babel par SWC afin d'obtenir des builds plus rapides, d'accélérer l'exécution des tests ou de compiler des fonctionnalités ECMAScript modernes.

Qu'est-ce que Agent-Skills ?

Cette compétence fournit une expertise complète sur SWC (Speedy Web Compiler), un compilateur haute performance basé sur Rust utilisé dans Next.js et Deno. Elle guide les utilisateurs dans la configuration de .swcrc pour la transpilation TypeScript/JavaScript moderne, l'utilisation de l'API `@swc/core` pour la compilation programmatique, et l'accélération des tests Jest avec `@swc/jest`. La compétence couvre également la minification des ressources de production, les meilleures pratiques pour 2026, et le dépannage des erreurs courantes. Elle aide à remplacer Babel par SWC pour des builds jusqu'à 20 fois plus rapides, optimiser les pipelines de bundlers modernes, et gérer la manipulation AST.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/G1Joshi/Agent-Skills/tree/HEAD/skills/tools/swc

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

SWC

SWC (Speedy Web Compiler) est une plateforme extensible basée sur Rust. C'est le compilateur utilisé par Next.js et Deno.

Quand l'utiliser

  • Transpilation JavaScript/TypeScript haute performance : Remplacement de Babel par un compilateur Rust jusqu'à 20 fois plus rapide.
  • Pipelines Next.js et bundlers modernes : Transpilation de React JSX, TSX, des fonctionnalités ECMAScript modernes, et des ressources Webpack/Turbopack.
  • Manipulation AST et génération de code programmatique : Création d'outils de build personnalisés rapides avec l'API Node.js @swc/core.
  • Minification des ressources de production : Minification des bundles JS et CSS à des vitesses extrêmes avec le minifieur @swc/core.

Démarrage rapide

1. Fichier .swcrc minimal

{
  "$schema": "https://json.schemastore.org/swcrc",
  "jsc": {
    "parser": {
      "syntax": "typescript",
      "tsx": true,
      "decorators": true
    },
    "transform": {
      "react": {
        "runtime": "automatic"
      }
    },
    "target": "es2022"
  },
  "minify": false
}

2. Compilation via CLI

npx @swc/cli src -d dist

Concepts clés

Configuration SWC de production (.swcrc)

Configuration du TypeScript moderne, du runtime React 19 JSX, et de la transpilation des modules :

{
  "$schema": "https://json.schemastore.org/swcrc",
  "jsc": {
    "parser": {
      "syntax": "typescript",
      "tsx": true,
      "decorators": true,
      "dynamicImport": true
    },
    "transform": {
      "react": {
        "runtime": "automatic",
        "refresh": true
      }
    },
    "target": "es2022",
    "loose": false,
    "externalHelpers": true,
    "keepClassNames": true,
    "minify": {
      "compress": {
        "unused": true,
        "drop_console": true
      },
      "mangle": true
    }
  },
  "module": {
    "type": "es6"
  },
  "minify": true,
  "sourceMaps": true
}

Compilation programmatique avec l'API @swc/core

Transpilation de fichiers source de manière asynchrone dans des scripts Node.js :

import swc from "@swc/core";
import fs from "node:fs/promises";

async function compileTypeScript(filePath) {
  const code = await fs.readFile(filePath, "utf-8");

  const output = await swc.transform(code, {
    filename: filePath,
    sourceMaps: true,
    jsc: {
      parser: { syntax: "typescript", tsx: true },
      target: "es2022",
    },
    module: { type: "commonjs" },
  });

  console.log("Code transpilé :\n", output.code);
  if (output.map) {
    console.log("Source Map générée");
  }
}

compileTypeScript("./src/index.ts");

Transpilation CLI haute vitesse

Compilation directe d'arbres de répertoires avec la ligne de commande SWC :

# Transpiler src/ vers dist/ avec les source maps
npx swc src -d dist --copy-files --source-maps

# Transpiler et bundle avec swcpack
npx swc src/index.ts -o dist/bundle.js --minify

Modèles courants

Accélération des tests Jest avec @swc/jest

Problème : La transpilation TypeScript avec ts-jest rend les suites de tests très lentes.
Solution : Remplacer ts-jest par @swc/jest.

// jest.config.js
module.exports = {
  transform: {
    "^.+\\.(t|j)sx?$": [
      "@swc/jest",
      {
        jsc: {
          transform: {
            react: { runtime: "automatic" },
          },
        },
      },
    ],
  },
};

Pipeline de bundling et minification SWC

Problème : Nécessité d'une minification rapide pour les scripts de build de production.
Solution : Activer les options minify dans .swcrc.

{
  "minify": true,
  "jsc": {
    "minify": {
      "compress": {
        "drop_console": true
      },
      "mangle": true
    }
  }
}

Meilleures pratiques (2026)

  • Faites installer @swc/helpers et activer externalHelpers: true pour éviter de dupliquer les stubs d'aide au runtime du transpilateur.
  • Faites associer SWC à tsc --noEmit dans les pipelines CI/CD car SWC transpile le code sans effectuer de vérification de types.
  • Faites configurer target: "es2022" ou plus récent pour tirer parti des capacités natives des navigateurs modernes.
  • Faites utiliser @swc/jest ou @swc/register pour accélérer considérablement l'exécution des tests unitaires.
  • Ne faites pas dépendre des plugins Babel à moins que ce ne soit strictement nécessaire ; vérifiez si des plugins SWC natifs (plugins Wasm) existent.
  • Ne faites pas commiter les répertoires de cache de build .swc dans les dépôts Git.
  • Ne faites pas exécuter la minification SWC sans générer des source maps pour le dépannage en production.

Dépannage

Erreur / SymptômeCauseSolution
failed to handle: error parsing typescriptSyntaxe TypeScript (ex. JSX ou décorateurs) utilisée sans activer les flags dans .swcrcAssurez-vous que "syntax": "typescript", "tsx": true, et "decorators": true sont présents dans jsc.parser.
Les métadonnées des décorateurs ne sont pas émises (Reflect.getMetadata retourne undefined)transform.legacyDecorator et transform.decoratorMetadata non configurésDéfinissez "legacyDecorator": true et "decoratorMetadata": true dans jsc.transform.
Cannot find module '@swc/core-darwin-arm64'L'installation du binaire natif a échoué lors de l'installation npm/yarnExécutez npm install --force @swc/core pour déclencher le téléchargement du binaire natif pour l'architecture cible.

Références

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

G1Joshi/Agent-Skills

Expert Dask distributed computing assistance covering Dask DataFrames, Arrays, Futures, and cluster scaling. Use when analyzing datasets too large for pandas on a single machine or multi-node cluster.

G1Joshi/Agent-Skills

Expert dbt (data build tool) assistance covering SQL modeling, Jinja macros, tests, documentation, and semantic layer. Use when building analytics engineering pipelines on BigQuery, Snowflake, or PostgreSQL.

G1Joshi/Agent-Skills

Expert JAX assistance covering Autograd, XLA compilation (`jit`), vectorization (`vmap`), and parallelization (`pmap`). Use when building high-performance numerical computing and cutting-edge deep learning research.

G1Joshi/Agent-Skills

Expert Ray distributed computing assistance covering Ray Core (actors, tasks), Ray Train, Ray Tune, and Ray Serve. Use when scaling Python compute and ML training across multi-node clusters.

G1Joshi/Agent-Skills

Expert Git version control assistance covering branching, interactive rebase, cherry-pick, submodules, worktrees, and conflict resolution. Use when managing source code history and collaboration workflows.

G1Joshi/Agent-Skills

Expert K9s CLI assistance covering terminal Kubernetes cluster navigation, real-time log streaming, port forwarding, and pod debugging. Use when managing and troubleshooting Kubernetes clusters with speed.

G1Joshi/Agent-Skills

Expert Tig assistance covering text-mode interface for Git, interactive staging, commit graph visualization, diff exploration, and blame navigation. Use when navigating Git commit history in the terminal, staging hunks interactively, browsing file changes, or reviewing revisions.

G1Joshi/Agent-Skills

Expert Vim assistance covering modal editing, .vimrc configuration, registers, macros, search/replace, and plugin management via vim-plug. Use when editing text efficiently in terminal environments, writing Vimscript, recording macros, or configuring core Vim settings.

G1Joshi/Agent-Skills

Expert Zed editor assistance covering high-performance Rust-based text editing, multi-buffer editing, language server protocols (LSP), and AI assistant integrations. Use when configuring Zed settings.json, setting up language extensions, collaborating in real-time channels, or optimizing editor startup speed.

G1Joshi/Agent-Skills

Expert Zsh assistance covering shell customization, Oh My Zsh plugins, Zinit plugin manager, prompt engineering (Starship/Powerlevel10k), and shell scripting. Use when configuring .zshrc, writing Zsh automation scripts, optimizing shell startup time, or configuring tab-completion.

G1Joshi/Agent-Skills

Expert [skill-name] assistance covering [feature 1], [feature 2], and [feature 3]. Use when [working with X], [debugging Y], or [implementing Z].

Skills associés