Skip to content

feat: add reusable GitHub Actions workflows as plugin#2

Merged
aviadr1 merged 12 commits intomainfrom
aviadr1/reusable-github-actions
Jan 11, 2026
Merged

feat: add reusable GitHub Actions workflows as plugin#2
aviadr1 merged 12 commits intomainfrom
aviadr1/reusable-github-actions

Conversation

@aviadr1
Copy link
Owner

@aviadr1 aviadr1 commented Jan 11, 2026

Summary

  • Add 4 reusable GitHub Actions workflows that other repositories can call directly
  • Add github-actions plugin to the marketplace with skill and command
  • Update README with documentation for reusable workflows

Reusable Workflows

Workflow Purpose Key Inputs
reusable-pr-review.yml Automatic PR review model, timeout_minutes, review_prompt
reusable-docs-sync.yml Keep docs in sync with code days_back, docs_paths, code_patterns
reusable-code-quality.yml Periodic code quality audits num_dirs, source_dir, lint_command
reusable-dependency-audit.yml Dependency updates & security node_version, lint_command, test_command

Usage Example

# In any repository's .github/workflows/claude-pr-review.yml
name: Claude PR Review

on:
  pull_request:
  issue_comment:
    types: [created]

jobs:
  review:
    uses: aviadr1/claude-code-showcase/.github/workflows/reusable-pr-review.yml@main
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

New Plugin Components

  • Skill: .claude/skills/github-actions/SKILL.md - Full documentation for all workflows
  • Command: /setup-github-actions - Interactive setup wizard

Test Plan

  • Verify reusable workflows can be called from another repository
  • Test /setup-github-actions command creates correct workflow files
  • Confirm all symlinks are valid (./scripts/validate-symlinks.sh)

🤖 Generated with Claude Code

@aviadr1 @claude
feat: add reusable GitHub Actions workflows as plugin
0ca732b 
- Add 4 reusable workflows callable from other repos:
  - reusable-pr-review.yml: Automatic PR review
  - reusable-docs-sync.yml: Keep docs in sync with code
  - reusable-code-quality.yml: Periodic code quality audits
  - reusable-dependency-audit.yml: Dependency updates & security

- Add github-actions skill with full documentation
- Add /setup-github-actions command for interactive setup
- Add github-actions plugin to marketplace with symlinks
- Update README with reusable workflows section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 aviadr1 requested a review from Copilot January 11, 2026 11:40
Copilot AI reviewed Jan 11, 2026
View reviewed changes
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds reusable GitHub Actions workflows as a new plugin to enable Claude Code CI/CD automation in any repository. The workflows provide PR review, documentation sync, code quality audits, and dependency management capabilities that can be called directly without copying workflow files.

Changes:

  • Added 4 reusable GitHub Actions workflows for Claude Code automation
  • Created github-actions plugin with comprehensive skill documentation and setup command
  • Updated README with documentation and usage examples for the reusable workflows

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.

Show a summary per file
File Description
.github/workflows/reusable-pr-review.yml Reusable workflow for automatic PR reviews using Claude
.github/workflows/reusable-docs-sync.yml Reusable workflow to keep documentation synchronized with code changes
.github/workflows/reusable-code-quality.yml Reusable workflow for periodic code quality audits on random directories
.github/workflows/reusable-dependency-audit.yml Reusable workflow for dependency updates and security audits
.claude/skills/github-actions/SKILL.md Complete documentation for all reusable workflows with usage examples
.claude/commands/setup-github-actions.md Interactive setup wizard command for configuring workflows
plugins/github-actions/.claude-plugin/plugin.json Plugin manifest for the github-actions bundle
plugins/github-actions/skills/github-actions Symlink to the skill documentation
plugins/github-actions/commands/setup-github-actions.md Symlink to the setup command
.claude-plugin/marketplace.json Registry entry for the new github-actions plugin
README.md Documentation for reusable workflows and local workflows distinction

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

aviadr1 and others added 11 commits January 11, 2026 13:45
@aviadr1 @claude
fix: use auto-updating 'opus' alias for model default
1c7cfcd 
Changed from pinned 'claude-opus-4-5-20251101' to 'opus' alias
which automatically updates to the latest Claude Opus version.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
fix: resolve code review warnings
810856c 
1. reusable-code-quality.yml: Fixed shell script to properly iterate
   over space-separated file extensions. Previously ".ts .tsx" was
   incorrectly expanded as "*.ts .tsx" instead of checking each
   extension separately.

2. reusable-docs-sync.yml: Replaced format() with environment variables
   to avoid potential issues with file paths containing braces like
   "utils/{helpers}.ts" being misinterpreted as template placeholders.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
docs: add stack compatibility labels to workflows
2d17ea6 
- Add compatibility table showing which workflows work with any stack
  vs Node.js specific
- PR Review and Docs Sync: Generic (git only, any language)
- Code Quality and Dependency Audit: Node.js (requires npm)
- Add "Adapting for Other Stacks" section with Python/Go/Rust examples
- Update README workflow table with Stack column

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
rename: add 'Node.js' to stack-specific workflow names
f54936f 
- Rename reusable-code-quality.yml → reusable-nodejs-code-quality.yml
- Rename reusable-dependency-audit.yml → reusable-nodejs-dependency-audit.yml
- Update internal workflow names to include "Node.js"
- Update all documentation references in SKILL.md, README.md, and setup command

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
rename: change 'Reusable' to 'Showcase' in workflow names
3cb25c3 
- Update workflow display names from "Reusable - X" to "Showcase - X"
- Update descriptions in SKILL.md, README.md, plugin.json, marketplace.json

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
fix: correct workflow filenames in setup command
462408c 
Update setup-github-actions.md to reference the correct Node.js workflow names:
- reusable-code-quality.yml → reusable-nodejs-code-quality.yml
- reusable-dependency-audit.yml → reusable-nodejs-dependency-audit.yml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
fix: update 'reusable' to 'showcase' in setup command text
3a8c25b 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
rename: workflow files from reusable-* to showcase-*
b4abdce 
- Rename all workflow files to use 'showcase-' prefix
- Update all documentation references (README.md, SKILL.md, setup command)

Files renamed:
- reusable-pr-review.yml → showcase-pr-review.yml
- reusable-docs-sync.yml → showcase-docs-sync.yml
- reusable-nodejs-code-quality.yml → showcase-nodejs-code-quality.yml
- reusable-nodejs-dependency-audit.yml → showcase-nodejs-dependency-audit.yml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
docs: clarify reusable vs example workflows
742f92b 
- Add "How It Works" section to SKILL.md explaining workflow_call concept
- Clarify README sections: "Showcase Workflows (Reusable)" vs "Local Workflows (Examples)"
- Explain that local workflows are caller examples showing how to use the reusable ones

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
fix: update workflows for claude-code-action@beta API changes
eb355e4 
- Add `id-token: write` permission for OIDC authentication
- Replace deprecated `prompt` with `direct_prompt`
- Replace deprecated `claude_args` with `max_turns` and `allowed_tools`
- Remove deprecated `track_progress` input

Fixes CI/CD errors from updated anthropics/claude-code-action@beta

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 @claude
fix: update workflows for claude-code-action@beta API changes
8491a3b 
- Add missing `id-token: write` permission required for OIDC auth
- Replace invalid inputs with correct ones:
  - `track_progress` → removed (not supported)
  - `prompt` → `direct_prompt`
  - `claude_args` → `max_turns` and `allowed_tools`

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aviadr1 aviadr1 merged commit 3b15edb into main Jan 11, 2026
1 check failed
@aviadr1 aviadr1 deleted the aviadr1/reusable-github-actions branch January 11, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@aviadr1