Skip to content

feat: added design comments skill#113

Open
dlabaj wants to merge 1 commit into
patternfly:mainfrom
dlabaj:design-comments
Open

feat: added design comments skill#113
dlabaj wants to merge 1 commit into
patternfly:mainfrom
dlabaj:design-comments

Conversation

@dlabaj

@dlabaj dlabaj commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Added ability to run patternfly design comment system via a skill.

Summary by CodeRabbit

  • New Features

    • Added PF Design Comments skill enabling easy integration of design feedback capabilities into React applications with optional GitHub and Jira synchronization.
  • Documentation

    • Added complete guide covering installation, configuration, and usage of PF Design Comments, including prerequisites, environment setup, and integration options.

@coderabbitai

coderabbitai Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

A new pf-design-comments skill is added to the React plugin collection. This consists of a new 138-line SKILL.md guide covering installation, environment configuration, verification, uninstall, manual integration fallback, and usage reference, along with corresponding entries in PLUGINS.md and plugins/react/README.md.

Changes

PF Design Comments Skill Documentation

Layer / File(s) Summary
New SKILL.md usage guide
plugins/react/skills/pf-design-comments/SKILL.md
Introduces the complete skill guide: prerequisites, install/init workflow (npx design-comments init), .env/.env.server configuration, verification checklist, uninstall procedure, overlay/widget usage reference, and manual integration fallback steps.
Plugin index and React README registration
PLUGINS.md, plugins/react/README.md
Adds the pf-design-comments row to the React plugin table in PLUGINS.md, and adds the skill route entry plus the skills/pf-design-comments/ directory to the React plugin README.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • patternfly/ai-helpers#50: Renamed/migrated pf-react/* skills to react/* in the same plugin listings and docs files that this PR extends with the new pf-design-comments skill entry.

Suggested reviewers

  • jpuzz0
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: added design comments skill' directly and clearly summarizes the main change — introducing a new design comments skill to the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
⚔️ Resolve merge conflicts
  • Resolve merge conflict in branch design-comments

Warning

Review ran into problems

🔥 Problems

Linked repositories: Your configuration references 1 linked repositories, but your current plan allows 0. Analyzed ``, skipped anthropics/claude-plugins-official.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/react/skills/pf-design-comments/SKILL.md`:
- Around line 1-4: The pf-design-comments skill is missing the required
disable-model-invocation: true flag in its frontmatter. Add this flag to the
frontmatter section in the SKILL.md file alongside the existing name and
description fields to properly indicate that this skill has file-system side
effects and should only be invoked by users, not by the AI model
programmatically.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 01d243ea-8cdd-4558-a64e-405d6aa6d72e

📥 Commits

Reviewing files that changed from the base of the PR and between bd8becd and 676afa4.

📒 Files selected for processing (3)
  • PLUGINS.md
  • plugins/react/README.md
  • plugins/react/skills/pf-design-comments/SKILL.md

Comment on lines +1 to +4
---
name: pf-design-comments
description: Integrate @patternfly/design-comments into React apps for on-page design feedback, pinned comment threads, GitHub Issues sync, and Jira linking. Use when adding design comments, review overlays, or removing the commenting system from a PatternFly React project.
---

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.

⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

Add disable-model-invocation: true to frontmatter — this skill has side effects.

The skill executes npx design-comments init, which modifies multiple project files (src/app/index.tsx, src/app/routes.tsx, src/app/AppLayout/AppLayout.tsx, webpack.dev.js), creates new files (src/app/Comments/Comments.tsx, env templates), and adds webpack middleware. These are file-system mutations and therefore side effects that require the disable-model-invocation: true flag per PatternFly ai-helpers conventions (CONTRIBUTING-SKILLS.md and retrieved learnings on PR 77). This ensures only the user can invoke the skill, not the AI model programmatically.

🔧 Proposed frontmatter fix
 ---
 name: pf-design-comments
 description: Integrate `@patternfly/design-comments` into React apps for on-page design feedback, pinned comment threads, GitHub Issues sync, and Jira linking. Use when adding design comments, review overlays, or removing the commenting system from a PatternFly React project.
+disable-model-invocation: true
 ---
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
---
name: pf-design-comments
description: Integrate @patternfly/design-comments into React apps for on-page design feedback, pinned comment threads, GitHub Issues sync, and Jira linking. Use when adding design comments, review overlays, or removing the commenting system from a PatternFly React project.
---
---
name: pf-design-comments
description: Integrate `@patternfly/design-comments` into React apps for on-page design feedback, pinned comment threads, GitHub Issues sync, and Jira linking. Use when adding design comments, review overlays, or removing the commenting system from a PatternFly React project.
disable-model-invocation: true
---
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/react/skills/pf-design-comments/SKILL.md` around lines 1 - 4, The
pf-design-comments skill is missing the required disable-model-invocation: true
flag in its frontmatter. Add this flag to the frontmatter section in the
SKILL.md file alongside the existing name and description fields to properly
indicate that this skill has file-system side effects and should only be invoked
by users, not by the AI model programmatically.

Sources: Coding guidelines, Learnings

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.

1 participant