bonny/WordPress-Simple-History

og-share-images

Creates Open Graph / social share images (1200x630) for blog posts and announcements by rendering HTML in a headless browser. Use when a post needs an OG image, share card, or social preview graphic.

create-logger

Guides creation of custom loggers for Simple History. Use when building a new logger class to log WordPress events.

logger-messages

Enforces active voice for logger messages and the Event Details API. Use when writing a new logger class or modifying message arrays in get_info().

teaser-screenshots

Reproducibly capture in-product UI screenshots (admin popovers, settings teasers, dashboard widgets) used as embedded images in premium upsell teasers. Use whenever a teaser image needs refreshing after the underlying UI changes.

testing

Guidance for writing and running tests in Simple History, including the Premium add-on. Covers which framework to use, how to run existing tests, how to create new ones (codegen recording workflow), and how to test Premium (whose PHP tests live in this repo,…

wp-org-screenshots

How to design and regenerate marketing screenshots for the wordpress.org plugin page (banner-1544x500.png, screenshot-1.png, etc). Covers the event mix that converts, the reproducible WordPress Playground pipeline that bakes it, and every non-obvious gotcha…

changelog

Adds changelog entries to readme.txt following keepachangelog format. Use when updating the Unreleased section or documenting changes for a release.

premium-translate

Translates Simple History Premium plugin strings for one or multiple locales. Use when translating or updating premium plugin PO files.

premium-version-update

Updates the Simple History Premium plugin version in all required locations, then builds and archives the distributable release zip. Use when bumping the premium version or cutting a premium release.

image-optimization

Compresses PNG, JPEG, and GIF images before they are committed (pngquant + oxipng pipeline, jpegoptim/mozjpeg, vips, gifsicle). Use when adding or updating any image in the repo, such as wordpress.org screenshots, banners, teaser images, or OG share cards.

worktree

Creates an isolated git worktree with its own WordPress test environment. Use when working on multi-day features or risky changes needing parallel testing.

simple-history-voice

Pär's writing voice and per-text-type rules for Simple History, on top of the humanizer skill. Use whenever writing or editing text people will read — changelog entries, GUI copy and notices, blog posts, newsletters, customer emails, docs, commit messages and…

quick-wins

Surface and triage local issues that are safe and quick for an AI to implement and easy for a human to verify. Use when the user wants to "knock out issues", asks for "quick wins", "low-hanging fruit", "what's easy to do right now", or wants a batch of small…

populate-log

Populates the event log with test data via WP-CLI. Use when adding sample events, generating test data, or benchmarking with realistic activity.

sql

Runs SQL queries against the WordPress development database. Use when inspecting tables, checking event data, or debugging database issues.

wp-playground

Use for quick local testing with WordPress Playground CLI. Spins up a disposable WordPress instance with the plugin mounted — no Docker needed. Ideal for worktrees, quick feature checks, and parallel testing on different branches.

action-links

Guides implementation of structured action links on log events. Use when adding get_action_links() to a logger or migrating from get_log_row_details_output().

git-commits

Project-specific git commit guidance for Simple History. Use when committing changes, especially across core and premium plugins.

wordpress-org-compliance

Reviews plugin code for WordPress.org compliance and trialware violations. Use when checking premium features, upsells, or license keys before submission.

wp-admin-urls

Patterns for building WordPress admin page URLs in Simple History. Use when constructing admin links, settings tabs, or menu URLs dynamically.

code-quality

Runs linting and static analysis on PHP/CSS/JS using phpcs, phpstan, and rector. Use when checking code style, fixing lint errors, or running static analysis.