Skip to content
New site — Virtual Media Folders now has its own home.Visit vmf.soderlind.no →

Skills

Public AI agent skills for WordPress development, JavaScript modernization, Azure infrastructure, architecture documentation, and pre-launch security audits.

skills.sh

Available Skills · Related Skills · Install · Usage · Invocation Strategy · Skill Notes

Skills for WordPress plugin and theme development.

SkillPurpose
wp-prepareScaffold or update a WordPress project with dev tooling, coding standards, testing, and i18n support.
wp-ability-authAudit or implement two-tier authorization for WordPress abilities and REST routes, catching IDOR gaps and inconsistent 403 contracts.
wp-bumpBump a WordPress plugin version and update related release metadata.
wp-cli-localRun WP-CLI commands against Local by Flywheel sites on macOS.
wp-mutateRun mutation testing on WordPress PHP and JavaScript to find weak tests, then triage surviving mutants.
wp-org-reviewPrepare a plugin for the WordPress.org Directory review, fixing findings the reviewer catches beyond Plugin Check/PHPCS.
wp-pcp-localRun the WordPress Plugin Check (PCP) against Local by Flywheel sites on macOS.

Skills for JavaScript modernization and dependency audits.

SkillPurpose
browser-nativeAudit JavaScript dependencies and identify packages replaceable by modern browser/runtime native APIs, with Baseline status and confidence.

Skills for Azure infrastructure and API Management.

SkillPurpose
add-apim-apiScaffold a new API in Azure API Management with Bicep infrastructure.

Skills for documenting and illustrating software architecture.

SkillPurpose
document-architectureCreate, improve, or audit repository architecture and concept documentation.
illustrate-designIllustrate a software design with evidence-backed architecture and sequence diagrams.

Skills for pre-launch security and abuse-resistance audits.

SkillPurpose
pre-launch-security-auditRun an evidence-backed security and abuse-resistance review before an application launch.

Language-agnostic release tooling.

SkillPurpose
bumpBump a project's version across every detected manifest, update the changelog from commit history, and run the project's own build and test gates.

Skills for acceptance and end-to-end testing.

SkillPurpose
acceptance-testLearn an app from code and docs, grill the user on acceptance criteria, then write and run Playwright acceptance tests.

These live in their own repositories and install from there, not from soderlind/skills:

SkillPurpose
use-just-bash-for-scriptsSteer the agent to dry-run generated or untrusted shell scripts through just-bash before touching the real host.
Terminal window
npx skills add soderlind/just-bash-runner

Every skill installs with the skills CLI. -g installs globally, so the skill is available in every project.

Install all skills from this repository:

Terminal window
npx skills add soderlind/skills -g

Install a single skill — swap in any name from Available Skills:

Terminal window
npx skills add soderlind/skills --skill wp-bump -g

Add --all to install into every detected agent integration without prompts:

Terminal window
npx skills add soderlind/skills -g --all

Browse, list, update, and remove:

Terminal window
npx skills add soderlind/skills --list # preview the skills in this repository
npx skills list -g # list installed skills
npx skills update wp-bump -g # update one skill
npx skills remove wp-bump -g # remove one skill

These skills are published as an Agent Skills discovery index (schema v0.2.0), so agents can enumerate and fetch them without the CLI:

Terminal window
curl https://soderlind.no/.well-known/agent-skills/index.json

Each entry carries a sha256: digest of its artifact — a single SKILL.md for skills with no supporting files, otherwise a .tar.gz of the skill directory. Clients must verify the digest before use and must not execute anything under scripts/ without explicit approval.

Regenerate the index and archives after changing any skill, then deploy the whole .well-known/agent-skills/ directory to the soderlind.no document root — it is self-contained, and every url in the index resolves inside it:

Terminal window
node scripts/build-agent-skills-index.mjs # rebuild
node scripts/build-agent-skills-index.mjs --check # fail if the committed output is stale (runs in CI)

The server must send application/json for index.json, application/gzip for .tar.gz, and text/markdown or text/plain for SKILL.md.

Archives are byte-reproducible (fixed mtimes, sorted entries), so unchanged skills produce unchanged digests. Use --base-url to point the index at a different origin:

Terminal window
node scripts/build-agent-skills-index.mjs --base-url https://example.com

After installation, ask your AI agent for the workflow you want and the matching skill is selected automatically. You can also target a skill directly with a slash command — /<skill-name> — optionally passing arguments, e.g. /wp-prepare i18n to run just the i18n phase.

Example invocations:

/add-apim-api speeches-api backend https://api.example.com/speeches
/wp-cli-local list plugins
/wp-prepare i18n
/wp-bump 1.2.3
/wp-mutate
/browser-native
/document-architecture
/illustrate-design
/pre-launch-security-audit
/bump 1.2.3
/acceptance-test checkout flow

Use model-invoked skills when autonomous triggering is important or when one skill should call another.

Use user-invoked skills when you want zero context load and explicit manual control.

When many user-invoked skills accumulate, add a lightweight router skill that maps tasks to the right skill so you do not rely on memory.

Terminal window
npx skills add soderlind/skills --skill add-apim-api -g

Use this to scaffold a new API in Azure API Management with Bicep infrastructure.

Prerequisites:

  • Azure CLI with Bicep extension
  • Existing APIM infrastructure project
  • Access to the target Azure subscription

Example prompt:

/add-apim-api speeches-api backend https://api.example.com/speeches

The skill guides you through gathering requirements, creating Bicep files, and wiring up the API.

Terminal window
npx skills add soderlind/skills --skill wp-cli-local -g

Use this when working with WordPress sites in Local by Flywheel.

Prerequisites:

  • macOS
  • Local by Flywheel installed
  • WP-CLI installed and available in PATH
  • The target Local site is running

The skill always routes WP-CLI through its bundled wrapper:

Terminal window
bash skills/wp-cli-local/scripts/wp --list
Terminal window
npx skills add soderlind/skills --skill wp-pcp-local -g

Use this to run the WordPress Plugin Check (PCP) against a plugin on a Local by Flywheel site.

Prerequisites:

  • macOS
  • Local by Flywheel installed
  • WP-CLI installed and available in PATH
  • The Plugin Check plugin installed and activated on the target site
  • The target Local site is running

The skill routes Plugin Check through its bundled wrapper, auto-detecting the site and plugin slug from the current directory:

Terminal window
bash skills/wp-pcp-local/scripts/pcp my-plugin
Terminal window
npx skills add soderlind/skills --skill wp-ability-auth -g

Use this to audit or implement authorization for WordPress abilities (wp_register_ability) and REST routes with a two-tier permission model: a coarse capability gate in permission_callback, then a per-object meta-capability check inside the execute callback.

It enforces:

  • A single WP_Error 403 contract across both tiers (never array('success' => false)).
  • A tier-2 per-object check on every ability that touches a specific object (IDOR guard).
  • Plural caps in tier 1 (edit_posts), singular meta-caps in tier 2 (edit_post, $id).
  • A centralized, filterable ability→capability map instead of scattered current_user_can.
  • An auth-principal check for MCP/agent or background invocations with no current user.

Example prompt:

/wp-ability-auth audit the abilities in this plugin
Terminal window
npx skills add soderlind/skills --skill wp-org-review -g

Use this to harden a plugin for the WordPress.org Plugin Directory review, catching the findings the reviewer flags but local tooling misses.

It audits and fixes:

  • Suppressed sniffs (phpcs:ignore / phpcs:disable) — real fix or justified ignore.
  • Arbitrary-path or disallowed-location filesystem writes.
  • Context-correct output escaping applied at the point of output.
  • readme.txt Contributors: mapping to the wp.org slug owner.
  • Bundled compiled translations that should not ship in the zip.

It also bundles reviewer-findings.md, a generic catalog distilled from real Plugin Directory review emails — every recurring finding (prefixing, location constants, filesystem writes, unneeded files, out-of-date libraries, update checkers, register_setting sanitization, textdomain, contributors, enqueuing, escaping, trademarks, external-service disclosure, dead URLs, readme accuracy) with a detection command and a fix for each.

Example prompt:

/wp-org-review respond to this plugin review email
Terminal window
npx skills add soderlind/skills --skill wp-prepare -g

Use this to set up or refresh a WordPress project with common development tooling.

Example prompt (pass a phase name to run just that phase):

/wp-prepare i18n

Prerequisites:

  • Node.js 18+
  • Composer 2+
  • PHP 8.3+
  • git
  • WP-CLI for i18n commands

Preview the setup plan before changing a project (paths below assume a clone of this repo; when installed, use the skill’s own directory):

Terminal window
node skills/wp-prepare/scripts/plan_setup.mjs --dry-run

Apply selected safe setup phases:

Terminal window
node skills/wp-prepare/scripts/plan_setup.mjs --apply --only=init,composer,config

Available phases (pass any comma-separated subset to --only= or --skip=):

Phase What it includes
plugin Plugin bootstrap <slug>.php generated from the collected metadata.
readme readme.txt from the plugin metadata (optional, opt-in only).
init Project basics: npm init -y, git init, a hand-written composer.json, and a git remote add origin prompt when missing.
skills Installs the essential agent skills via npx skills add; optional skills are noted to install only if relevant.
composer PHP dev deps (phpunit, brain/monkey, wpcs, phpcodesniffer-composer-installer, pest); merges test/lint/check scripts; scaffolds phpcs.xml, phpunit.xml.dist, and tests/.
config Creates or merges .editorconfig and .gitignore.
vitest Installs vitest jsdom; scaffolds vitest.config.js, tests/setup.js, and a test:js npm script.
eslint Installs eslint @wordpress/eslint-plugin; creates .eslintrc.json, .eslintignore, and a lint:js npm script.
i18n Scaffolds i18n-map.json, a languages/ directory, and i18n npm scripts keyed to the text domain.
instructions Downloads .github/instructions/wordpress.instructions.md from github/awesome-copilot (manual fallback if offline).
cleanup Removes a stray yarn.lock.
Terminal window
npx skills add soderlind/skills --skill wp-bump -g

Use this for WordPress plugin releases. It updates existing version fields, changelog entries, build outputs, and test checks according to the target project.

Example prompt:

/wp-bump 1.2.3

The skill does not create commits, tags, or releases unless you explicitly ask your agent to do so.

Terminal window
npx skills add soderlind/skills --skill bump -g

Use this for releases in any language. It detects the version files that already exist — package.json, Cargo.toml, pyproject.toml, composer.json, *.csproj, pom.xml, build.gradle, *.gemspec, pubspec.yaml, mix.exs, plain VERSION files — syncs them to the target version, drafts a changelog entry from git log since the last tag, and runs the project’s own build and test scripts as a release gate.

It only touches files that are present, never edits dependency versions, prefers each ecosystem’s own tool (npm version, cargo set-version, poetry version) when a lockfile is present, and leaves commits, tags, and releases to you unless you explicitly ask. For WordPress plugin releases (main-file header, readme.txt stable tag), use wp-bump instead.

Example prompt:

/bump 1.2.3
Terminal window
npx skills add soderlind/skills --skill wp-mutate -g

Use this to measure test quality rather than test coverage. Mutation testing changes your source in small ways and re-runs the suite; a mutant that survives marks a line that runs but is never asserted.

Prerequisites:

  • An existing test suite. This skill does not create one — use wp-prepare first.
  • PHP: Pest 3+ (native --mutate) or PHPUnit (Infection), plus Xdebug 3+ with xdebug.mode=coverage, or PCOV. Without a coverage driver Pest refuses to start.
  • JavaScript: Vitest or Jest, for StrykerJS.

Five failure modes are specific to WordPress plugins, and each one produces a clean-looking run rather than an error. The skill checks for all of them:

  • PCOV auto-detects pcov.directory and often picks an asset folder such as lib/, so every file reports 0.0% coverage.
  • Pest’s --everything enumerates classes via PSR-4, so WordPress class-*.php filenames are invisible to it. Scope with --path= instead.
  • Pest’s --parallel workers do not inherit -d ini flags, and mutants that time out are scored as killed — which can turn a real 60% into a reported 100%.
  • Brain Monkey (via Patchwork) stops Infection’s mutants from taking effect: the run either exits 0 with no summary or reports MSI 0%. The skill blocks that combination and routes you to Pest.
  • StrykerJS copies Composer’s vendor/ into its sandbox unless ignorePatterns says otherwise, then tries to parse PHP CodeSniffer’s HTML fixtures.

Because all five look like ordinary output, the skill verifies the harness before reporting any score: mutants were created, at least one was killed, and the kills are not just time-outs.

Preview what the skill would run against (path assumes a clone of this repo; when installed, use the skill’s own directory):

Terminal window
node skills/wp-mutate/scripts/detect_mutation_setup.mjs

Example prompt:

/wp-mutate

The skill reports two scores (overall and covered-code only), ranks surviving mutants with untested security controls first, and proposes assertions one at a time rather than rewriting tests on its own; see references/triage-playbook.md for the mutant-to-assertion mapping and references/glossary.md for the engine vocabulary differences.

Terminal window
npx skills add soderlind/skills --skill browser-native -g

Use this to scan JavaScript/Node.js dependencies and find packages that can be replaced with built-in APIs (fetch, URL, structuredClone, crypto.randomUUID, Intl, Object.groupBy, Set methods, <dialog>/Popover API, etc.).

Each finding carries a confidence level (does the native API do what the library does?) and a Baseline status (can your users run it? — widely / newly / limited), so you can tell the easy wins from swaps that need an audience check or a fallback.

Example prompt:

/browser-native

Run the local scanner directly (path assumes a clone of this repo; when installed, use the skill’s own directory):

Terminal window
node skills/browser-native/scripts/cli.js .

Markdown report with before/after examples:

Terminal window
node skills/browser-native/scripts/cli.js . --md
Terminal window
npx skills add soderlind/skills --skill document-architecture -g

Use this to create, improve, or audit repository architecture and concept documentation (architecture overviews, domain models, component boundaries, data/control flows, invariants, ADRs).

Example prompt:

/document-architecture

The skill labels current vs. proposed states explicitly and verifies claims against the repository before writing docs; see references/templates.md for document templates.

Terminal window
npx skills add soderlind/skills --skill illustrate-design -g

Use this to turn requirements, ADRs, code, and other design evidence into PR Lens architecture, sequence, and optional decision-dependency diagrams. Possible evidence includes a grill-with-docs interview (not required) and a document-architecture document, whose claims are checked against the code. Its rendering helper validates the graph and produces light/dark SVGs; the workflow converts PNG companions locally. The contrast checker measures WCAG 2.2 contrast in both themes. With your approval, --palette github colours the diagrams with GitHub Light/Dark Default syntax colours, or a palette file overrides individual roles.

Example prompt:

/illustrate-design

The workflow requires truthful repository provenance, compatible Node.js and PR Lens packages, a local SVG-to-PNG converter, and visual inspection. It labels unfinished designs as drafts and does not modify the source glossary, ADRs, or application code. Run node --test <repository>/skills/illustrate-design/scripts/test_render.mjs from a Node workspace with both PR Lens packages installed to test the helpers.

Terminal window
npx skills add soderlind/skills --skill pre-launch-security-audit -g

Use this to run a stack-agnostic security and abuse-resistance review before launching an application (MVP, SaaS, AI app, public API, or mobile backend).

Example prompt:

/pre-launch-security-audit

The skill inspects the repository first, tests failure cases, and ends with a launch recommendation (block, conditional, or baseline met) rather than a compliance certification; see references/checklist.md for the control set.

Terminal window
npx skills add soderlind/skills --skill acceptance-test -g

Use this to get Playwright acceptance tests that prove the app does what you agreed it should. The skill reads the code and docs to build a behavior inventory, then runs a grilling session (or its built-in round-based rules) to settle scope, actors, Given/When/Then criteria, and environment. It records them in tests/acceptance/CRITERIA.md and then writes one test per criterion.

Example prompt:

/acceptance-test checkout flow

Tests run with npx playwright test tests/acceptance. Each failure is classified as a test bug, an environment problem, or an app bug. App bugs are reported and never hidden by weakened assertions. See references/playwright.md for config, auth, and data patterns.

Each skill lives in its own folder under skills/:

.well-known/
agent-skills/ # generated discovery index + skill archives
scripts/
build-agent-skills-index.mjs
skills/
acceptance-test/
SKILL.md
references/
add-apim-api/
SKILL.md
references/
browser-native/
SKILL.md
references/
scripts/
wp-prepare/
SKILL.md
references/
scripts/
wp-bump/
SKILL.md
wp-cli-local/
SKILL.md
scripts/
wp-mutate/
SKILL.md
references/
scripts/
wp-pcp-local/
SKILL.md
scripts/
document-architecture/
SKILL.md
agents/
references/
illustrate-design/
SKILL.md
scripts/
pre-launch-security-audit/
SKILL.md
agents/
references/

All skills in this repository are licensed under the MIT License.

These skills build on, reference, or scaffold the following open-source projects and libraries:

Assisted-by: GitHub Copilot:GPT-5.3-Codex