WordPress Plugin Tag

Use this skill to manage WordPress plugin git tags based on the plugin header version.

Inputs

• •Action: create, verify, list, delete.
• •Optional: push, annotated, force.

Safety Rules

• •Stop if the working tree is dirty.
• •Confirm default branch before tagging.
• •Never delete or force without explicit user approval.
• •Never push tags unless the user explicitly asks.

Workflow

1. •

   Locate plugin file

   • •Look for a PHP file in repo root with a Plugin Name: header.
   • •If multiple files exist, ask the user to choose.
2. •

   Extract version

   • •Read Version: from the plugin header.
   • •Validate semantic format (MAJOR.MINOR.PATCH); warn if it does not match.
3. •

   Select action

   • •verify: confirm v<version> exists locally or on remote.
   • •list: show local and remote version tags.
   • •create: create v<version> tag on the current commit.
   • •delete: remove a tag locally and optionally from remote.
4. •

   Create tag (if requested)

   • •Confirm you are on the default branch and up to date.
   • •Ask if the tag should be annotated.
   • •If annotated, use the tag message template.
   • •Create the tag and report success.
5. •

   Push tag (optional)

   • •Only if the user explicitly requests it.
6. •

   Delete tag (optional)

   • •Ask for explicit confirmation before local or remote deletion.

Output

• •Show the detected plugin version.
• •Show the tag action taken and the final tag list.