Skip to content

[docs] Adding skills guide - #3282

Merged
brandonpayton merged 10 commits into
trunkfrom
adding-skills-guide
Feb 23, 2026
Merged

brandonpayton merged 10 commits into
trunkfrom
adding-skills-guide

Conversation

@fellyph

@fellyph fellyph commented Feb 17, 2026

Copy link
Copy Markdown
Collaborator

This pull request adds comprehensive documentation for using the WordPress Playground agent skill with Claude Code, and updates the guides index to include this new resource. The most important changes are:

New Documentation:

  • Added a detailed guide, agent-skill-wp-playground.md, explaining how to install, configure, and use the wp-playground agent skill with Claude Code. The guide covers prerequisites, installation steps, usage examples for various workflows (content generation, plugin/theme installation, version testing, debugging, complex scenarios), browser-only workflows, skill internals, troubleshooting, and next steps.

Documentation Index Update:

  • Updated index.md to include a link and summary for the new WordPress Playground agent skill guide, making it easier for users to discover and access this documentation.

## Summary
Introduces a comprehensive guide on installing and utilizing the wp-playground agent skill with Claude Code. The document covers prerequisites, installation steps, usage examples, and troubleshooting tips to streamline WordPress Playground workflows.
## Summary
Enhances the documentation by introducing a new guide on automating WordPress Playground workflows with the wp-playground agent skill. This guide provides insights on installation, usage, and practical applications for local testing and debugging.
## Summary
Refines the documentation for the WordPress Playground Agent Skill by correcting formatting and enhancing clarity in the installation and usage sections. This update ensures that users have a clearer understanding of the requirements and steps needed to effectively utilize the skill.
## Summary
Enhances the documentation for the WordPress Playground Agent Skill by clarifying language, improving formatting, and updating installation instructions. The changes ensure users have a better understanding of the requirements and steps for utilizing the skill effectively.
…Skill

## Summary
Introduces a new guide in Portuguese for the WordPress Playground Agent Skill, detailing installation, usage, and practical applications. This comprehensive document aims to assist users in automating WordPress workflows effectively, ensuring clarity in prerequisites and installation steps.
…ortuguese

## Summary
Removes the "Export to Production" section from the English and Portuguese versions of the WordPress Playground Agent Skill guide. This change streamlines the documentation, focusing on plugin and theme development resources while ensuring consistency across language versions.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive documentation for the WordPress Playground agent skill, enabling developers to automate WordPress Playground workflows using AI coding agents like Claude Code, Cursor, and others.

Changes:

  • Added a new guide explaining how to install and use the wp-playground agent skill with coding agents
  • Updated the guides index to include a link to the new agent skill documentation
  • Provided Portuguese translation of the complete guide

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
packages/docs/site/docs/main/guides/agent-skill-wp-playground.md New English documentation for the WordPress Playground agent skill, covering installation, usage examples, and workflows
packages/docs/site/docs/main/guides/index.md Added index entry linking to the new agent skill guide
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/agent-skill-wp-playground.md Portuguese translation of the agent skill guide

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@brandonpayton brandonpayton left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@fellyph, this looks good except let's fix the orphaned page lint failure before merging. It looks like nothing in the docs links to this page yet. That would be OK, but we don't want our CI tests failing until the page is linked within our documentation.

@fellyph

fellyph commented Feb 23, 2026

Copy link
Copy Markdown
Collaborator Author

@brandonpayton, there was a missing URL in the sidebar. I have included it now.

@brandonpayton
brandonpayton merged commit 55cd3bf into trunk Feb 23, 2026
44 checks passed
@brandonpayton
brandonpayton deleted the adding-skills-guide branch February 23, 2026 23:55
@rollybueno rollybueno mentioned this pull request Sep 21, 2026
fellyph pushed a commit that referenced this pull request Sep 22, 2026
### Motivation for the change, related issues
English docs/main/guides/index.md now lists 13 guides, including PHP
snippets
([#3644](#3644)),
PHP frameworks
([#3766](#3766)),
Playground for Everyone
([#3103](#3103)),
Blueprint content import
([#4032](#4032)),
PR preview buttons
([#2893](#2893)),
the agent skill
([#3282](#3282)),
runCLI
([#2833](#2833)),
PHPUnit
([#3487](#3487)),
and Playwright E2E
([#3360](#3360)).

The Tagalog index still had only the iOS, demo content, theme, and
plugin guides. /tl/guides readers would miss the newer entries, even
though Docusaurus can fall back to English for pages that are not
translated yet.

### Implementation details

1. Updated
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/guides/index.md.
2. Expanded the frontmatter description to match English.
3. Kept and aligned the four existing Tagalog entries (iOS / Blocknotes,
demo content, theme developers, plugin developers).
4. Added Tagalog blurbs for the nine missing guides, in the same order
as English.
5. Kept the original English above each block in HTML comments, per the
translation guide.
6. Testing Instructions (or ideally a Blueprint)
7. Docs-only change; no Blueprint.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **Documentation**
  - Expanded the Tagalog guides index from 4 to 13 guide links.
- Added translated guides covering PHP snippets and embeds, PHP
frameworks, WordPress Playground, Blueprints, GitHub Actions, the
Playground Agent Skill, CLI usage, PHPUnit, and Playwright testing.
- Revised the page description, introduction, and existing guide
sections for clearer Tagalog-language guidance.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants