superpowers-skills

🥈Silver

Community-edited skills for Claude Code's superpowers plugin. Operations teams can automate workflows by extending Claude's capabilities with custom skills. Integrates with existing systems through TypeScript-based scripts.

6071140Updated Yesterday

Intermediate30min to implementautomation

Saves ~60 min per use

Quick InstallView Source

git clone https://github.com/obra/superpowers-skills.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Define Your Automation Need**: Identify the repetitive task you want to automate (e.g., bulk Jira updates, GitHub label management, Slack notifications). Write down the exact inputs and outputs required. 2. **Set Up Development Environment**: Install the superpowers plugin in Claude Code (`npm install -g @superpowers/cli`), then initialize a new skill project (`superpowers init jira-bulk-updater`). 3. **Implement the Skill**: Use the provided TypeScript template to write your skill. Replace [PLACEHOLDERS] with your actual API endpoints, authentication methods, and business logic. Include proper error handling for network issues, rate limits, and invalid inputs. 4. **Test Locally**: Run your skill in test mode with mock data (`superpowers test jira-bulk-updater --mock`). Verify the output matches your expectations before deploying. 5. **Deploy and Integrate**: Publish your skill to your organization's skill registry (`superpowers publish jira-bulk-updater`). Configure your CI/CD pipeline to trigger the skill when specific events occur (e.g., new GitHub issues, Jira status changes). **Pro Tips:** - Start with a simple skill that handles one specific task before building complex multi-step workflows. - Use the `secret: true` parameter for API tokens to ensure they're not logged. - Add logging to track skill execution history and debug issues. - Document your skill's parameters and usage examples in the README.md file.

Use Cases

Automate the generation of boilerplate code for new projects.

Create custom scripts to manage dependencies and package installations.

Integrate third-party APIs to enhance application functionality with minimal effort.

Develop reusable skills that can be shared and improved by the community.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/obra/superpowers-skills

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Create a new custom skill for Claude Code's superpowers plugin that automates [SPECIFIC_TASK] in [SYSTEM/TOOL]. The skill should be written in TypeScript and include: 1) A clear description of its purpose, 2) Input parameters with [PLACEHOLDERS] for customization, 3) Error handling for common edge cases, and 4) Integration steps for [TARGET_SYSTEM]. Use the superpowers plugin's skill template structure.

Example Output

```typescript
// Skill: Jira Bulk Issue Updater
// Description: Automates bulk updates to Jira issues based on custom criteria
// Author: DevOps Team
// Version: 1.2

import { SuperpowerSkill } from '@superpowers/core';

export const jiraBulkUpdater: SuperpowerSkill = {
  id: 'jira-bulk-updater',
  name: 'Jira Bulk Issue Updater',
  description: 'Updates multiple Jira issues based on custom filters and field changes',
  parameters: {
    jiraUrl: {
      type: 'string',
      description: 'Base URL of your Jira instance (e.g., https://yourcompany.atlassian.net)',
      required: true
    },
    apiToken: {
      type: 'string',
      description: 'Jira API token (create at https://id.atlassian.com/manage-profile/security/api-tokens)',
      required: true,
      secret: true
    },
    projectKey: {
      type: 'string',
      description: 'JQL project key filter (e.g., PROJ)',
      required: true
    },
    statusUpdate: {
      type: 'string',
      description: 'New status to apply (e.g., "In Progress" or "Resolved")',
      required: true
    },
    priorityUpdate: {
      type: 'string',
      description: 'Optional priority update (e.g., "High")',
      required: false
    },
    comment: {
      type: 'string',
      description: 'Optional comment to add to each issue',
      required: false
    }
  },
  execute: async ({ jiraUrl, apiToken, projectKey, statusUpdate, priorityUpdate, comment }) => {
    try {
      const jira = new JiraClient(jiraUrl, apiToken);
      const issues = await jira.searchIssues(`project = ${projectKey}`);
      
      if (issues.length === 0) {
        return {
          success: true,
          message: `No issues found for project ${projectKey}`,
          updatedCount: 0
        };
      }

      let updatedCount = 0;
      const errors: string[] = [];

      for (const issue of issues) {
        try {
          await jira.updateIssue(issue.key, {
            status: statusUpdate,
            priority: priorityUpdate,
            comment: comment
          });
          updatedCount++;
        } catch (error) {
          errors.push(`Failed to update ${issue.key}: ${error.message}`);
        }
      }

      return {
        success: errors.length === 0,
        message: errors.length > 0 
          ? `${updatedCount} issues updated with ${errors.length} errors`
          : `${updatedCount} issues successfully updated`,
        updatedCount,
        errors
      };
    } catch (error) {
      throw new Error(`Jira bulk update failed: ${error.message}`);
    }
  }
};
```

**Usage Example:**
```bash
# Install the skill in your superpowers plugin
npm install @your-org/jira-bulk-updater

# Run the skill
superpowers run jira-bulk-updater --jiraUrl "https://acme.atlassian.net" --apiToken "[TOKEN]" --projectKey "ENG" --statusUpdate "In Progress" --comment "Bulk status update for QA review"
```

**Output:**
```json
{
  "success": true,
  "message": "12 issues updated with 0 errors",
  "updatedCount": 12,
  "errors": []
}
```