pproenca avatar

Wxt Browser Extensions

A comprehensive performance guide for WXT browser extension development with 49 prioritized rules across eight categories, from critical service worker lifecycle patterns to TypeScript conventions. Use this when building or refactoring WXT extensions to catch common pitfalls like service worker state management, content script injection timing, and messaging architecture mistakes. The categorization by impact level (critical to low-medium) is genuinely useful for knowing what to focus on first. Covers the full stack of extension development including manifest configuration, storage patterns, and bundle optimization. Updated for WXT v0.20+, so it reflects current best practices rather than outdated patterns that still float around in extension development tutorials.

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

Install

$ npx -y skills add pproenca/dot-skills --skill wxt-browser-extensions --agent claude-code

Installs into .claude/skills of the current project.

Files

Community WXT Browser Extensions Best Practices

Comprehensive performance optimization guide for WXT browser extension development. Contains 49 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation. Updated for WXT v0.20+.

When to Apply

Reference these guidelines when:

  • Writing new WXT browser extension code
  • Implementing service worker background scripts
  • Injecting content scripts into web pages
  • Setting up messaging between extension contexts
  • Configuring manifest permissions and resources

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Service Worker LifecycleCRITICALsvc-
2Content Script InjectionCRITICALinject-
3Messaging ArchitectureHIGHmsg-
4Storage PatternsHIGHstore-
5Bundle OptimizationMEDIUM-HIGHbundle-
6Manifest ConfigurationMEDIUMmanifest-
7UI PerformanceMEDIUMui-
8TypeScript PatternsLOW-MEDIUMts-

Quick Reference

1. Service Worker Lifecycle (CRITICAL)

Sponsors

Details

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

More from pproenca/dot-skills

All 100
1windmill-labs avatarrust-backendwindmill-labs/windmillRust coding guidelines for the Windmill backend. MUST use when writing or modifying Rust code in the backend directory.1.1Kskills.sh installs
2aiskillstore avatarskill-creatoraiskillstore/marketplaceGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabil1.1Kskills.sh installs
3kostja94 avatartoc-generatorkostja94/marketing-skillsWhen the user wants to add, optimize, or audit table of contents (TOC) for long-form content. Also use when the user mentions "TOC," "table of contents," "table1.1Kskills.sh installs
4niaka3dayo avatarunity-vrc-world-sdk-3niaka3dayo/agent-skills-vrc-udonVRChat World SDK 3 guide for scene and Inspector setup, component placement, optimization, and upload. Use for VRChat world scene configuration, VRC SDK compone1.1Kskills.sh installs
5franalgaba avatargrimoirefranalgaba/grimoireInstall and operate Grimoire, author .spell files with full syntax coverage (including advisory decision logic), and run compile/validate/simulate/cast safely. 1.1Kskills.sh installs
6cxuu avatargo-genericscxuu/golang-skillsUse when deciding whether to use Go generics, writing generic functions or types, choosing constraints, or picking between type aliases and type definitions. Al1.1Kskills.sh installs