From 192f792dbabf55e232a1318cba1e0ecaff1a1403 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Fri, 6 Feb 2026 14:51:48 +0000 Subject: [PATCH 1/5] Update README with Skills.sh installation guide Added installation instructions for Skills.sh to README. --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index 13273a7..ef5d765 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,27 @@ Agent Skills solve this by giving AI assistants **expert-level WordPress knowled ## Quick Start +### Installing skills with Skills.sh + +Skills.sh provides a guided process for finding and installing skills + +Finding skills available: + +```bash +npx skills add WordPress/agent-skills --list +``` +Installing skills: + +```bash +npx skills add WordPress/agent-skills --skill + +# Example of installing a specific skill +npx skills add WordPress/agent-skills --skill wp-plugin-development + +# Example of installing more than one skill +npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground +``` + ### Install globally for Claude Code ```bash From 3d3867bfa9f0b4768954f35f319322e826e36e73 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Fri, 6 Feb 2026 15:00:11 +0000 Subject: [PATCH 2/5] Add 'How It Works' section to README Moving the section explaining how the skills work to the top of the doc --- README.md | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index ef5d765..57bceea 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,24 @@ Agent Skills solve this by giving AI assistants **expert-level WordPress knowled | **wp-playground** | WordPress Playground for instant local environments | | **wpds** | WordPress Design System | +## How It Works + +Each skill is a self-contained folder with instructions, references, and optional scripts: + +``` +skills/wp-block-development/ +├── SKILL.md # Main instructions (when to use, procedure, verification) +├── references/ # Deep-dive docs on specific topics +│ ├── block-json.md +│ ├── deprecations.md +│ └── ... +└── scripts/ # Deterministic helpers (detection, validation) + └── list_blocks.mjs +``` + +When you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing. + + ## Quick Start ### Installing skills with Skills.sh @@ -121,23 +139,6 @@ node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cur Copy any skill folder from `skills/` into your project's instructions directory for your AI assistant. -## How It Works - -Each skill contains: - -``` -skills/wp-block-development/ -├── SKILL.md # Main instructions (when to use, procedure, verification) -├── references/ # Deep-dive docs on specific topics -│ ├── block-json.md -│ ├── deprecations.md -│ └── ... -└── scripts/ # Deterministic helpers (detection, validation) - └── list_blocks.mjs -``` - -When you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing. - ## Compatibility - **WordPress 6.9+** (PHP 7.2.24+) From 50719a6933983da183f9dc94752906d1010c5a93 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Fri, 6 Feb 2026 15:01:37 +0000 Subject: [PATCH 3/5] Refine installation instructions in README Updated the Quick Start section to streamline the installation instructions for skills. --- README.md | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 57bceea..3aec17e 100644 --- a/README.md +++ b/README.md @@ -54,24 +54,21 @@ When you ask your AI assistant to work on WordPress code, it reads these skills ## Quick Start -### Installing skills with Skills.sh +The fastest way to install skills is with a single command: -Skills.sh provides a guided process for finding and installing skills +```bash +npx skills add WordPress/agent-skills --skill wp-plugin-development +``` -Finding skills available: +To see all available skills: ```bash npx skills add WordPress/agent-skills --list ``` -Installing skills: -```bash -npx skills add WordPress/agent-skills --skill +To install multiple skills at once: -# Example of installing a specific skill -npx skills add WordPress/agent-skills --skill wp-plugin-development - -# Example of installing more than one skill +```bash npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground ``` From cc621d5d6e04e57f9e37fb43f825c68b2041335a Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Thu, 26 Mar 2026 20:56:23 +0000 Subject: [PATCH 4/5] Fix grammar and add Global vs. Project Scope section Corrected grammatical errors and added a section on skill installation scopes. --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3aec17e..4790ec4 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ AI coding assistants are powerful, but they often: - Skip proper block deprecations, causing "Invalid block" errors - Ignore existing tooling in your repo -Agent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use. +Agent Skills solves this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use. ## Available Skills @@ -52,6 +52,20 @@ skills/wp-block-development/ When you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing. +## Global vs. Project Scope + +Skills can be installed in two scopes: + +**Global** — installed in your home directory (e.g. `~/.claude/skills/`, `~/.cursor/skills/`). +- Available across **all** your projects automatically. +- Best for individual developers who want WordPress knowledge in every repo. + +**Project** — installed inside a repository (e.g. `.claude/skills/`, `.github/skills/`, `.cursor/skills/`). +- Available only within **that specific project**. +- Can be committed to version control so the entire team benefits. + +You can use both at the same time. When a skill exists in both scopes, the project-level version is used. + ## Quick Start The fastest way to install skills is with a single command: From ff837eb7b463203e643a027c03722c76e9a9985d Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Thu, 26 Mar 2026 22:33:24 +0000 Subject: [PATCH 5/5] Fix grammatical error in README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4790ec4..f4813f3 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ AI coding assistants are powerful, but they often: - Skip proper block deprecations, causing "Invalid block" errors - Ignore existing tooling in your repo -Agent Skills solves this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use. +Agent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use. ## Available Skills