Skip to content

feat(skills): Add figma-changes skill to pf-figma plugin#25

Open
kaylachumley wants to merge 1 commit intomainfrom
add-figma-changes-skill
Open

feat(skills): Add figma-changes skill to pf-figma plugin#25
kaylachumley wants to merge 1 commit intomainfrom
add-figma-changes-skill

Conversation

@kaylachumley
Copy link

Adds a comprehensive skill for tracking Figma design updates and generating code update checklists. The skill:

  • Fetches Figma version history via API
  • Generates three types of reports: design changelog, release notes, and code update checklist
  • Cross-references GitHub issues from patternfly-design-kit and chatbot repos
  • Categorizes updates by status (code update needed, design-only, needs verification)
  • Creates token-focused checklists (color, spacer, dimension tokens) for developers
  • Includes reference documentation and helper scripts

This skill helps PatternFly maintainers keep code in sync with Figma design updates.

Adds a comprehensive skill for tracking Figma design updates and generating code update checklists. The skill:

- Fetches Figma version history via API
- Generates three types of reports: design changelog, release notes, and code update checklist
- Cross-references GitHub issues from patternfly-design-kit and chatbot repos
- Categorizes updates by status (code update needed, design-only, needs verification)
- Creates token-focused checklists (color, spacer, dimension tokens) for developers
- Includes reference documentation and helper scripts

This skill helps PatternFly maintainers keep code in sync with Figma design updates.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@kaylachumley kaylachumley changed the title Add figma-changes skill to pf-figma plugin fea(skills): Add figma-changes skill to pf-figma plugin Mar 18, 2026
@kaylachumley kaylachumley changed the title fea(skills): Add figma-changes skill to pf-figma plugin feat(skills): Add figma-changes skill to pf-figma plugin Mar 18, 2026
Copy link
Collaborator

@jpuzz0 jpuzz0 left a comment

Choose a reason for hiding this comment

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

Just 1 non-blocking suggestion. If you want to leave as-is, let me know and we can merge. Otherwise I'll wait till the comment is addressed.

@@ -0,0 +1,265 @@
---
Copy link
Collaborator

@jpuzz0 jpuzz0 Mar 20, 2026

Choose a reason for hiding this comment

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

nit: At 265 lines, the three report templates are the main source of length. Could these be moved to examples/ or references/? You already have examples/sample-output.md which demonstrates the format well.

Copy link
Author

Choose a reason for hiding this comment

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

yes they can be moved! not sure how to do that though @jpuzz0 Sorry for the late response, I was on PTO

Copy link
Collaborator

Choose a reason for hiding this comment

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

No worries! Here's a prompt you can give Claude or Cursor in the repo to do it for you:

In plugins/pf-figma/skills/figma-changes/SKILL.md, extract the three report templates into a separate file called `report-templates.md` in the same directory. Replace them in SKILL.md with a link to the new file.

@@ -0,0 +1,267 @@
#!/usr/bin/env node
Copy link
Collaborator

Choose a reason for hiding this comment

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

Not all users will have Node.js installed, and if they don't, this will fail silently with command not found. Adding a runtime check at the top would help — something like:

#!/bin/bash
command -v node >/dev/null 2>&1 || { echo "Error: This skill requires Node.js." >&2; exit 1; }

Or you could wrap the Node call in the bash extract script that already exists. I'll be updating CONTRIBUTING-SKILLS.md separately to clarify our policy on scripts in skills.

@jpuzz0 jpuzz0 self-requested a review March 23, 2026 20:35
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.

2 participants