Skip to content

Add design system agent skills for common workflows#78068

Open
Adi-ty wants to merge 2 commits into
WordPress:trunkfrom
Adi-ty:add/design-system-agent-skills
Open

Add design system agent skills for common workflows#78068
Adi-ty wants to merge 2 commits into
WordPress:trunkfrom
Adi-ty:add/design-system-agent-skills

Conversation

@Adi-ty
Copy link
Copy Markdown
Contributor

@Adi-ty Adi-ty commented May 7, 2026

What?

Closes #77209

This PR adds a set of design system agent skills for common workflows in .agents/skills/, covering:

  • component implementation
  • adapting designs to code
  • design system contribution workflows
  • design system code review

Each skill is split into a SKILL.md entry point plus focused reference files, instead of a single monolithic skill.

Why?

Agents working with the WordPress Design System often lack the repo-specific context needed to complete common tasks reliably. This includes workflows like implementing components with @wordpress/ui, translating designs into code, contributing new components or tokens, and reviewing design system changes.

How?

This PR introduces four skills under .agents/skills/:

  • design-system-component-implementation
  • design-system-figma-to-code
  • design-system-contribution
  • design-system-code-review

Use of AI Tools

GitHub Copilot was used to help research repository conventions, and refine the skill content, and review the resulting files for accuracy and consistency. All generated content was manually reviewed and edited before submission.

@Adi-ty Adi-ty changed the title Add agent skills for design system workflows Add design system agent skills for common workflows May 7, 2026
@Adi-ty
Copy link
Copy Markdown
Contributor Author

Adi-ty commented May 7, 2026

Happy to iterate on the implementation details here based on feedback.

I started with a simple Markdown-based structure in .agents/skills so the skill content itself is easier to review first. Should we consider packaging them so they can be installed via different skill registries? If we’d prefer a different location, packaging model, or installation flow, I’m happy to adjust the implementation in this PR.

@Adi-ty Adi-ty marked this pull request as ready for review May 8, 2026 04:28
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 8, 2026

Warning: Type of PR label mismatch

To merge this PR, it requires exactly 1 label indicating the type of PR. Other labels are optional and not being checked here.

  • Required label: Any label starting with [Type].
  • Labels found: .

Read more about Type labels in Gutenberg. Don't worry if you don't have the required permissions to add labels; the PR reviewer should be able to help with the task.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 8, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: Adi-ty <iamadisingh@git.wordpress.org>
Co-authored-by: aduth <aduth@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

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.

Design System: Provide agent skills for design system usage workflows

1 participant