/configure:claude-plugins

Configure a project to use the laurigates/claude-plugins Claude Code plugin marketplace. Sets up .claude/settings.json permissions and GitHub Actions workflows (claude.yml, claude-code-review.yml) with the marketplace pre-configured.

Context

• Settings file exists: !test -f .claude/settings.json
• Workflows: !find .github/workflows -maxdepth 1 -name 'claude*.yml' 2>/dev/null
• Git remote: !git remote get-url origin 2>/dev/null

Parameters

Available Plugins

The plugin list is maintained in the marketplace repository. To see all available plugins:

# List all plugins from marketplace
curl -s https://raw.githubusercontent.com/laurigates/claude-plugins/main/.claude-plugin/marketplace.json | jq -r '.plugins[].name'

# Or locally if you have the repo
jq -r '.plugins[] | "\(.name) - \(.description)"' .claude-plugin/marketplace.json

Common plugin categories:

• Language: typescript-plugin, python-plugin, rust-plugin
• Infrastructure: configure-plugin, container-plugin, kubernetes-plugin, terraform-plugin
• Quality: code-quality-plugin, testing-plugin
• Workflows: git-plugin, github-actions-plugin, blueprint-plugin
• AI/Agents: agent-patterns-plugin, agents-plugin, langchain-plugin
• Utilities: tools-plugin, documentation-plugin, hooks-plugin

Workflow

Phase 1: Detection

1. Check for existing .claude/settings.json
2. Check for existing .github/workflows/claude.yml
3. Check for existing .github/workflows/claude-code-review.yml
4. Detect project type (language, framework)

Phase 2: Configure .claude/settings.json

Create or merge into .claude/settings.json the following structure:

{
  "permissions": {
    "allow": [
      "Bash(git status *)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git branch *)",
      "Bash(git add *)",
      "Bash(git commit *)",
      "Bash(git push *)",
      "Bash(git remote *)",
      "Bash(git checkout *)",
      "Bash(git fetch *)",
      "Bash(gh pr *)",
      "Bash(gh run *)",
      "Bash(gh issue *)",
      "Bash(pre-commit *)",
      "Bash(detect-secrets *)",
      "mcp__context7",
      "mcp__sequential-thinking"
    ]
  }
}

Important: If .claude/settings.json already exists, MERGE the permissions.allow array without duplicating entries. Preserve any existing hooks, env, or other fields.

Phase 3: Configure .github/workflows/claude.yml

Create .github/workflows/claude.yml with the Claude Code action configured to use the plugin marketplace:

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Run Claude Code
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          plugin_marketplaces: |
            https://github.com/laurigates/claude-plugins.git
          plugins: |
            PLUGINS_LIST

Replace PLUGINS_LIST with the selected plugins in the format:

plugin-name@laurigates-claude-plugins

One plugin per line. For example with default recommended plugins:

          plugins: |
            git-plugin@laurigates-claude-plugins
            code-quality-plugin@laurigates-claude-plugins
            testing-plugin@laurigates-claude-plugins

Phase 4: Configure .github/workflows/claude-code-review.yml

Create .github/workflows/claude-code-review.yml for automatic PR reviews:

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  contents: read
  pull-requests: write
  issues: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          prompt: |
            Review this pull request. Focus on:
            - Code quality and best practices
            - Potential bugs or security issues
            - Test coverage gaps
            - Documentation needs
          claude_args: "--max-turns 5"
          plugin_marketplaces: |
            https://github.com/laurigates/claude-plugins.git
          plugins: |
            code-quality-plugin@laurigates-claude-plugins
            testing-plugin@laurigates-claude-plugins

Phase 5: Report

Generate a status report:

Claude Plugins Configuration Report
=====================================
Repository: <repo-name>

.claude/settings.json:
  Status:          <CREATED|UPDATED|EXISTS>
  Permissions:     <N> allowed patterns configured

.github/workflows/claude.yml:
  Status:          <CREATED|UPDATED|EXISTS>
  Marketplace:     laurigates/claude-plugins
  Plugins:         <list>

.github/workflows/claude-code-review.yml:
  Status:          <CREATED|UPDATED|EXISTS>
  Trigger:         PR opened/synchronize/reopened
  Plugins:         <list>

Next Steps:
  1. Add CLAUDE_CODE_OAUTH_TOKEN to repository secrets
     Settings > Secrets and variables > Actions > New repository secret
  2. Commit and push the new workflow files
  3. Test by mentioning @claude in a PR comment

Plugin Selection Logic

If --plugins is not specified, select recommended plugins based on project type:

Flags

Important Notes

• The CLAUDE_CODE_OAUTH_TOKEN secret must be added manually to the repository
• If using AWS Bedrock or Google Vertex AI, adjust the authentication section accordingly
• The plugin marketplace URL uses HTTPS Git format: https://github.com/laurigates/claude-plugins.git
• Plugins are referenced as <plugin-name>@laurigates-claude-plugins (marketplace name from marketplace.json)

See Also

• /configure:workflows – General GitHub Actions workflow configuration
• /configure:all – Run all compliance checks
• claude-security-settings skill – Claude Code security settings