OpenStack Claude Skills

Custom Claude Code skills for OpenStack development workflows.

Table of Contents

• About
• Skills
• openstack-review
• openstack-backport
• Installation
• Method 1: Plugin Marketplace (Recommended)
• Method 2: Manual Installation (Development)
• Method 3: Local Marketplace
• Verify Installation
• Development
• Adding New Skills
• Skill Format
• Contributing
• License
• Author
• Acknowledgments

About

This repository contains custom skills for Claude Code that enhance the development experience when working with OpenStack projects.

Skills

openstack-review

Review OpenStack patches from Gerrit with standardized analysis and inline comments.

Usage:

review this openstack patch <change-id>

Features:

• Fetches patches directly from OpenStack's Gerrit (review.opendev.org)
• Performs comprehensive code review across multiple dimensions:
• Code quality and logic errors
• OpenStack-specific conventions (hacking rules, Oslo patterns)
• Test coverage and quality
• Documentation completeness
• Commit message format
• Generates structured review reports with severity levels (BLOCKING, SUGGESTION, NIT)
• Provides actionable inline comments ready to post back to Gerrit

Examples:

• review this openstack patch 978095
• review openstack change 123456
• check this gerrit patch 999999

openstack-backport

Analyze commits to identify backport candidates for OpenStack stable branches based on the official backport policy.

Usage:

check backports for the last 15 commits
what needs backporting to stable branches since 2024.1?
find backport candidates from the last month

Features:

• Fetches maintained branch status from OpenStack releases repository
• Supports flexible commit range specification (by count, tag, date, or range)
• Parses bug references from OpenStack commit messages (Closes-Bug, Partial-Bug, Related-Bug)
• Queries Launchpad API to verify bug priorities
• Enforces OpenStack backport policy (only Critical/High priority bugs qualify)
• Checks if commits are already backported to avoid duplicate work
• Generates comprehensive reports with:
• Summary statistics
• Backport candidates grouped by commit and by branch
• Excluded commits with reasons (Medium/Low priority, no bug reference, features)
• Executable cherry-pick commands for each stable branch

Examples:

• check the last 20 commits for backport candidates
• what needs backporting to stable branches since 2024.1?
• find backport candidates between 2023.2 and HEAD
• show me what commits should go to stable/2024.1

Installation

Method 1: Plugin Marketplace (Recommended)

If this repository is hosted on GitHub, you can install skills via the plugin marketplace:

1. Add the marketplace to Claude Code:

   /plugin marketplace add <github-username>/openstack-claude-skills

1. Install skills:

   /plugin install openstack-review@openstack-skills
   /plugin install openstack-backport@openstack-skills

Method 2: Manual Installation (Development)

For local development or if you want to modify the skills:

1. Clone this repository:

   git clone <your-repo-url> ~/dev/openstack-claude-skills

1. Create symlinks to Claude's skills directory:

   ln -s ~/dev/openstack-claude-skills/openstack-review ~/.claude/skills/openstack-review
   ln -s ~/dev/openstack-claude-skills/openstack-backport ~/.claude/skills/openstack-backport

1. Restart Claude Code or reload skills (skills are loaded automatically)

Method 3: Local Marketplace

You can also add your local repository as a marketplace:

1. Edit your Claude Code settings (~/.claude/settings.json):

   {
     "extraKnownMarketplaces": {
       "openstack-skills": {
         "source": {
           "source": "local",
           "path": "/home/your-username/dev/openstack-claude-skills"
         }
       }
     }
   }

1. Install skills:

   /plugin install openstack-review@openstack-skills
   /plugin install openstack-backport@openstack-skills

Verify Installation

After installation, the skills should appear in Claude Code's available skills list. You can verify by:

• Asking Claude to review an OpenStack patch
• Asking Claude to check backport candidates in an OpenStack repository

Development

Adding New Skills

1. Create a new directory in this repository:

   cd ~/dev/openstack-claude-skills
   mkdir my-new-skill

1. Create the skill file following Claude Code's skill format

1. Symlink to Claude's directory:

   ln -s ~/dev/openstack-claude-skills/my-new-skill ~/.claude/skills/my-new-skill

1. Commit and push:

   git add my-new-skill/
   git commit -m "Add my-new-skill"
   git push

Skill Format

Skills should follow the Claude Code skill specification. See the openstack-review skill as an example.

Contributing

Contributions are welcome! Please:

1. Fork this repository
2. Create a feature branch
3. Test your changes thoroughly
4. Submit a pull request

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Author

Hervé Beraud

Acknowledgments

• OpenStack community for the development workflows this automates
• Anthropic for Claude Code and the skills framework