ai-helpers

AI Helpers

A collection of Claude Code plugins to automate and assist with various development tasks.

Installation

From the Claude Code Plugin Marketplace

1. Add the marketplace:

   /plugin marketplace add coreos/ai-helpers
   

2. Install a plugin:

   /plugin install pipeline-status@ai-helpers
   

3. Use the commands:

   /pipeline-status
   

Using Cursor

Cursor is able to find the various commands defined in this repo by making it available inside your ~/.cursor/commands directory.

$ mkdir -p ~/.cursor/commands
$ git clone [email protected]:coreos/ai-helpers.git
$ ln -s ai-helpers ~/.cursor/commands/ai-helpers

Plugin Development

Want to contribute or create your own plugins? Check out the plugins/ directory for examples.

Ethical Guidelines

Plugins, commands, skills, and hooks must NEVER reference real people by name, even as stylistic examples (e.g., "in the style of ").

Ethical rationale:

1. Consent: Individuals have not consented to have their identity or persona used in AI-generated content
2. Misrepresentation: AI cannot accurately replicate a person's unique voice, style, or intent
3. Intellectual Property: A person's distinctive style may be protected
4. Dignity: Using someone's identity without permission diminishes their autonomy

Instead, describe specific qualities explicitly

Good examples:

• "Write commit messages that are direct, technically precise, and focused on the rationale behind changes"
• "Explain using clear analogies, a sense of wonder, and accessible language for non-experts"
• "Code review comments that are encouraging, constructive, and focus on collaborative improvement"

When you identify a desirable characteristic (clarity, brevity, formality, humor, etc.), describe it explicitly rather than using a person as proxy.

Adding New Commands

When contributing new commands:

1. If your command fits an existing plugin: Add it to the appropriate plugin's commands/ directory
2. If your command doesn't have a clear parent plugin: Add it to the utils plugin (plugins/utils/commands/)
   • The utils plugin serves as a catch-all for commands that don't fit existing categories
   • Once we accumulate several related commands in utils, they can be segregated into a new targeted plugin

Creating a New Plugin

If you're contributing several related commands that warrant their own plugin:

1. Create a new directory under plugins/ with your plugin name
2. Create the plugin structure:

   plugins/your-plugin/
   ├── .claude-plugin/
   │   └── plugin.json
   └── commands/
       └── your-command.md
   

3. Register your plugin in .claude-plugin/marketplace.json

License

See LICENSE for details.