odh-ai-helpers

AI Helpers

This repository is a collaborative place hosting collections of AI plugins to automate and assist with various tasks.

[!NOTE] Right now the focus is to support Claude Code, OpenCode.ai, Gemini Gems, and Cursor AI. Other tools are welcome here, please submit Pull Requests.

[!NOTE] This project was inspired by the OpenShift AI helpers.

Got an Idea?

Have an idea for a new plugin, command, or assistant but not sure how to implement it? We'd love to hear about it! Simply file a GitHub issue with your idea in the title and we'll work together to make it happen.

[!TIP] Share your idea

No implementation details needed - just describe what you'd like to automate or what workflow you think could be improved. The community can help figure out the best way to build it.

Want to work on an issue? Comment /assign on it to assign yourself.

Tools Development

This repository is made for collaboration. We highly welcome contributions.

For skills, check out the helpers/skills/ directory for examples. For agents, see the helpers/agents/ directory. Using AI code assistant itself to develop the tools is highly encouraged.

Adding New Tools

When contributing new tools:

1. Skills: Add to the helpers/skills/ directory following the agentskills.io format
2. Agents: Add to the helpers/agents/ directory with appropriate documentation
3. Gemini Gems: Add to the helpers/gems/ directory

Once you have added the tool, you'd have to run have to run make update in order to generate the website data. Then you should git commit your change and after than running make lint would run local tests to validate the syntax.

Testing a plugin locally (example with Claude Code)

1. Open claude
2. Run /plugin marketplace add ./
3. Run /plugin then install the local plugin
4. Test plugin and remove local marketplace after done testing which will remove plugin
5. You can now reinstall from the git marketplace

Tool Registry

The AI Helpers marketplace uses a centralized category registry in categories.yaml to organize specialized tools by category. Tools not listed in any category are automatically placed in the "General" category - perfect for most contributions!

Category Registry Structure

Specialized tool categories are registered in categories.yaml:

CategoryName:
  - specialized-tool
  - another-tool

AnotherCategory:
  - domain-specific-tool

Adding a New Category

To add a new category, edit categories.yaml to include the new category as a top-level key:

1. Add category with tools:

   YourCategory:
     - your-tool-name
     - another-tool
   

2. Update documentation: Run make update to regenerate the website

Automatic Management

The build system automatically handles tool organization and validation:

• Tools not in categories.yaml are automatically assigned to "General" category
• Tool types are inferred from filesystem structure
• Duplicate tool names across categories are prevented
• All tools require valid names and types

Using with Claude Code

Claude Code Marketplace extends Claude's functionality with custom commands, agents, and skills for specific workflows and tasks. They enable you to automate repetitive development activities, integrate with tools, and create specialized AI assistants tailored to your needs.

For comprehensive information about plugin architecture and development, see the official Claude Code plugins documentation.

Install the tools from the Marketplace

1. Add the marketplace:

   /plugin marketplace add opendatahub-io/ai-helpers
   

2. Install a plugin:

   /plugin install odh-ai-helpers
   

[!TIP] To browse and install multiple plugins interactively, use /plugin after adding the marketplace. This will show you all available plugins and allow you to install them selectively. For a complete list of all available tools, see categories.yaml or visit our website.

3. Use the commands:

   /hello-world:echo Hello from OpenDataHub!
   

Running Claude Code in a Container

For IDE users, we have supplied a devcontainer.json file. For setup and prerequisites, see Dev Container README.

For setup with the standard CLI see the following.

A container image is available with Claude Code and all plugins pre-installed: ghcr.io/opendatahub-io/ai-helpers:latest

You can also build it yourself by running:

podman build -f images/claude/Containerfile -t ai-helpers .