Skip to content

patternfly/ai-helpers

Repository files navigation

PatternFly AI Helpers

AI coding helpers for PatternFly development. This repository provides plugins and documentation to help AI tools generate accurate, best-practice PatternFly applications.

Plugins work in both Claude Code and Cursor. The content is identical — only the install path differs.

Quick Start

Claude Code

# Add the marketplace
/plugin marketplace add patternfly/ai-helpers

# Install the plugins you need
/plugin install pf-react@ai-helpers

After installation, the plugin's agents and skills are available in any project.

Cursor

Cursor can discover plugins from .cursor-plugin/ directories. If you also have Claude Code installed, Cursor may pick up installed plugins automatically via its third-party plugin settings.

Available Plugins

Plugin Description
pf-a11y Accessibility auditing, reporting, and documentation for PatternFly applications
pf-figma Figma design review, diffing, and asset identification for PatternFly
pf-react PatternFly React coding standards and unit test generation agents
pf-styling CSS, SCSS, design tokens, and visual styling for PatternFly
pf-workflow Issue tracking, PR management, and cross-repo coordination for PatternFly projects

See PLUGINS.md for skills, agents, and usage details.

PatternFly MCP Server (Recommended)

For the best experience, also install the PatternFly MCP server which gives AI tools access to component documentation, prop schemas, and design guidelines. Skills and agents work without it but provide enhanced results when it's available.

Architecture

graph TD
    A[AI Tool] -->|discovers| B[".<tool>-plugin/marketplace.json"]
    B -->|references| C[plugins/pf-react]
    B -->|references| D[plugins/pf-a11y]
    B -->|references| E[plugins/...]
    C --- F[skills/ + agents/]
    D --- G[skills/ + agents/]
    E --- H[skills/ + agents/]
Loading

How it works

  1. Each AI tool looks for its own directory (.claude-plugin/, .cursor-plugin/) to find marketplace.json
  2. The marketplace lists plugins with relative paths to plugins/<name>/
  3. Each plugin has identical manifests in .claude-plugin/plugin.json and .cursor-plugin/plugin.json
  4. Adding support for a new tool = copying the manifest into a new .<tool>-plugin/ directory

Repository Structure

ai-helpers/
├── .claude-plugin/       # Claude Code marketplace config
├── .cursor-plugin/       # Cursor marketplace config
├── plugins/
│   └── <plugin-name>/    # One directory per plugin
│       ├── .claude-plugin/
│       ├── .cursor-plugin/
│       ├── skills/
│       └── agents/
└── docs/                 # AI-friendly PatternFly documentation

Documentation

The docs/ directory contains comprehensive, AI-friendly PatternFly documentation. See docs/README.md for the full table of contents.

Contributing

See CONTRIBUTING.md for guidelines on adding plugins, skills, and documentation.

See CONTRIBUTING-SKILLS.md for a step-by-step guide to creating and contributing a skill.

References

License

MIT

About

AI plugin marketplace for Red Hat UXD — PatternFly development, design, and productivity.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors