wordpress-plugins-repo-worktrees

Synchronize Git worktree operations with wp-config.php updates in WordPress plugin monorepos.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/andreilupu/my-claude-skills --skill wordpress-plugins-repo-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wordpress-plugins-repo-worktrees
Source: https://github.com/andreilupu/my-claude-skills/tree/main/skills/wordpress-plugins-repo-worktrees
Command: npx skills add https://github.com/andreilupu/my-claude-skills --skill wordpress-plugins-repo-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the management of multiple Git worktrees within a WordPress monorepo where wp-content/plugins is the Git repository, ensuring WordPress correctly identifies and uses the active plugin set by updating wp-config.php.

Core Features & Use Cases

  • Worktree Synchronization: Keeps Git worktree status aligned with WordPress's active plugin directory configuration.
  • Workflow Automation: Automates the process of creating, switching to, and removing Git worktrees while maintaining wp-config.php integrity.
  • Use Case: You need to quickly switch between developing a new feature on a separate branch and fixing a bug on another. This skill helps you manage these parallel development environments seamlessly within your WordPress project.

Quick Start

Use the wordpress-plugins-repo-worktrees skill to list all available git worktrees and check which one WordPress is currently configured to use.

Frequently Asked Questions about wordpress-plugins-repo-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Git worktrees for a WordPress plugin monorepo?

To manage Git worktrees in a WordPress plugin monorepo, you synchronize Git operations with manual `wp-config.php` updates to ensure WordPress correctly identifies and uses the active plugin directory configuration for each worktree.

Why does WordPress load the wrong plugins when I switch Git worktrees?

WordPress loads incorrect plugins because the active worktree directory path does not match the `wp-config.php` configuration. You must manually update `wp-config.php` to designate the active worktree path before switching Git branches.

How does worktree synchronization keep WordPress plugin development environments aligned?

Worktree synchronization keeps Git worktree status aligned with WordPress by orchestrating the creation, switching, and removal of worktrees while maintaining `wp-config.php` integrity for the current active plugin directory.

Can I use Git worktrees when `wp-content/plugins` is the main repository?

Yes, you can use Git worktrees when `wp-content/plugins` is the Git repository. This setup allows you to manage parallel development environments by updating the WordPress configuration to point to the active worktree.

What naming conventions are required for WordPress plugin worktrees?

Managing WordPress plugin worktrees requires adherence to specific naming conventions for the worktree directories. Following these conventions ensures the synchronization between Git operations and `wp-config.php` updates functions correctly.

How do I list all available Git worktrees and check the active WordPress configuration?

You can list all available Git worktrees and check which plugin directory WordPress is currently configured to use by running the Skill's initialization command, which verifies the synchronization status between Git and `wp-config.php`.