{"slug":"github-code-review","title":"github-code-review","summary":"Comprehensive GitHub code review with AI-powered swarm coordination","platform":"Claude","tags":["code-review","automation"],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-31T17:34:57.202899Z","repo":{"url":"https://github.com/spencermarx/open-code-review","stars":389,"forks":39,"license":"Apache-2.0","updatedAt":"2026-11-11T10:30:36Z"},"bodyHtml":"<hr>\n<p>name: github-code-review\nversion: 1.0.0\ndescription: Comprehensive GitHub code review with AI-powered swarm coordination\ncategory: github\ntags: [code-review, github, swarm, pr-management, automation]\nauthor: Claude Code Flow\nrequires:</p>\n<ul>\n<li>github-cli</li>\n<li>ruv-swarm</li>\n<li>claude-flow\ncapabilities:</li>\n<li>Multi-agent code review</li>\n<li>Automated PR management</li>\n<li>Security and performance analysis</li>\n<li>Swarm-based review orchestration</li>\n<li>Intelligent comment generation</li>\n<li>Quality gate enforcement</li>\n</ul>\n<hr>\n<h1>GitHub Code Review Skill</h1>\n<blockquote>\n<p><strong>AI-Powered Code Review</strong>: Deploy specialized review agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.</p>\n</blockquote>\n<h2>\uD83C\uDFAF Quick Start</h2>\n<h3>Simple Review</h3>\n<pre><code># Initialize review swarm for PR\ngh pr view 123 --json files,diff | npx ruv-swarm github review-init --pr 123\n\n# Post review status\ngh pr comment 123 --body \"\uD83D\uDD0D Multi-agent code review initiated\"\n</code></pre>\n<h3>Complete Review Workflow</h3>\n<pre><code># Get PR context with gh CLI\nPR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)\nPR_DIFF=$(gh pr diff 123)\n\n# Initialize comprehensive review\nnpx ruv-swarm github review-init \\\n  --pr 123 \\\n  --pr-data \"$PR_DATA\" \\\n  --diff \"$PR_DIFF\" \\\n  --agents \"security,performance,style,architecture,accessibility\" \\\n  --depth comprehensive\n</code></pre>\n<hr>\n<h2>\uD83D\uDCDA Table of Contents</h2>\n<details>\n<summary><strong>Core Features</strong></summary>\n<ul>\n<li><a href=\"#multi-agent-review-system\">Multi-Agent Review System</a></li>\n<li><a href=\"#specialized-review-agents\">Specialized Review Agents</a></li>\n<li><a href=\"#pr-based-swarm-management\">PR-Based Swarm Management</a></li>\n<li><a href=\"#automated-workflows\">Automated Workflows</a></li>\n<li><a href=\"#quality-gates--checks\">Quality Gates &amp; Checks</a></li>\n</ul>\n</details>\n<details>\n<summary><strong>Review Agents</strong></summary>\n<ul>\n<li><a href=\"#security-review-agent\">Security Review Agent</a></li>\n<li><a href=\"#performance-review-agent\">Performance Review Agent</a></li>\n<li><a href=\"#architecture-review-agent\">Architecture Review Agent</a></li>\n<li><a href=\"#style--convention-agent\">Style &amp; Convention Agent</a></li>\n<li><a href=\"#accessibility-agent\">Accessibility Agent</a></li>\n</ul>\n</details>\n<details>\n<summary><strong>Advanced Features</strong></summary>\n<ul>\n<li><a href=\"#context-aware-reviews\">Context-Aware Reviews</a></li>\n<li><a href=\"#learning-from-history\">Learning from History</a></li>\n<li><a href=\"#cross-pr-analysis\">Cross-PR Analysis</a></li>\n<li><a href=\"#custom-review-agents\">Custom Review Agents</a></li>\n</ul>\n</details>\n<details>\n<summary><strong>Integration &amp; Automation</strong></summary>\n<ul>\n<li><a href=\"#cicd-integration\">CI/CD Integration</a></li>\n<li><a href=\"#webhook-handlers\">Webhook Handlers</a></li>\n<li><a href=\"#pr-comment-commands\">PR Comment Commands</a></li>\n<li><a href=\"#automated-fixes\">Automated Fixes</a></li>\n</ul>\n</details>\n<hr>\n<h2>\uD83D\uDE80 Core Features</h2>\n<h3>Multi-Agent Review System</h3>\n<p>Deploy specialized AI agents for comprehensive code review:</p>\n<pre><code># Initialize review swarm with GitHub CLI integration\nPR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)\nPR_DIFF=$(gh pr diff 123)\n\n# Start multi-agent review\nnpx ruv-swarm github review-init \\\n  --pr 123 \\\n  --pr-data \"$PR_DATA\" \\\n  --diff \"$PR_DIFF\" \\\n  --agents \"security,performance,style,architecture,accessibility\" \\\n  --depth comprehensive\n\n# Post initial review status\ngh pr comment 123 --body \"\uD83D\uDD0D Multi-agent code review initiated\"\n</code></pre>\n<p><strong>Benefits:</strong></p>\n<ul>\n<li>✅ Parallel review by specialized agents</li>\n<li>✅ Comprehensive coverage across multiple domains</li>\n<li>✅ Faster review cycles with coordinated analysis</li>\n<li>✅ Consistent quality standards enforcement</li>\n</ul>\n<hr>\n<h2>\uD83E\uDD16 Specialized Review Agents</h2>\n<h3>Security Review Agent</h3>\n<p><strong>Focus:</strong> Identify security vulnerabilities and suggest fixes</p>\n<pre><code># Get changed files from PR\nCHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')\n\n# Run security-focused review\nSECURITY_RESULTS=$(npx ruv-swarm github review-security \\\n  --pr 123 \\\n  --files \"$CHANGED_FILES\" \\\n  --check \"owasp,cve,secrets,permissions\" \\\n  --suggest-fixes)\n\n# Post findings based on severity\nif echo \"$SECURITY_RESULTS\" | grep -q \"critical\"; then\n  # Request changes for critical issues\n  gh pr review 123 --request-changes --body \"$SECURITY_RESULTS\"\n  gh pr edit 123 --add-label \"security-review-required\"\nelse\n  # Post as comment for non-critical issues\n  gh pr comment 123 --body \"$SECURITY_RESULTS\"\nfi\n</code></pre>\n<details>\n<summary><strong>Security Checks Performed</strong></summary>\n<pre><code>{\n  \"checks\": [\n    \"SQL injection vulnerabilities\",\n    \"XSS attack vectors\",\n    \"Authentication bypasses\",\n    \"Authorization flaws\",\n    \"Cryptographic weaknesses\",\n    \"Dependency vulnerabilities\",\n    \"Secret exposure\",\n    \"CORS misconfigurations\"\n  ],\n  \"actions\": [\n    \"Block PR on critical issues\",\n    \"Suggest secure alternatives\",\n    \"Add security test cases\",\n    \"Update security documentation\"\n  ]\n}\n</code></pre>\n</details>\n<details>\n<summary><strong>Comment Template: Security Issue</strong></summary>\n<pre><code>\uD83D\uDD12 **Security Issue: [Type]**\n\n**Severity**: \uD83D\uDD34 Critical / \uD83D\uDFE1 High / \uD83D\uDFE2 Low\n\n**Description**:\n[Clear explanation of the security issue]\n\n**Impact**:\n[Potential consequences if not addressed]\n\n**Suggested Fix**:\n```language\n[Code example of the fix]\n</code></pre>\n<p><strong>References</strong>:</p>\n<ul>\n<li><a href=\"link\">OWASP Guide</a></li>\n<li><a href=\"link\">Security Best Practices</a></li>\n</ul>\n<pre><code>\n&lt;/details&gt;\n\n---\n\n### Performance Review Agent\n\n**Focus:** Analyze performance impact and optimization opportunities\n\n```bash\n# Run performance analysis\nnpx ruv-swarm github review-performance \\\n  --pr 123 \\\n  --profile \"cpu,memory,io\" \\\n  --benchmark-against main \\\n  --suggest-optimizations\n</code></pre>\n<details>\n<summary><strong>Performance Metrics Analyzed</strong></summary>\n<pre><code>{\n  \"metrics\": [\n    \"Algorithm complexity (Big O analysis)\",\n    \"Database query efficiency\",\n    \"Memory allocation patterns\",\n    \"Cache utilization\",\n    \"Network request optimization\",\n    \"Bundle size impact\",\n    \"Render performance\"\n  ],\n  \"benchmarks\": [\n    \"Compare with baseline\",\n    \"Load test simulations\",\n    \"Memory leak detection\",\n    \"Bottleneck identification\"\n  ]\n}\n</code></pre>\n</details>\n<hr>\n<h3>Architecture Review Agent</h3>\n<p><strong>Focus:</strong> Evaluate design patterns and architectural decisions</p>\n<pre><code># Architecture review\nnpx ruv-swarm github review-architecture \\\n  --pr 123 \\\n  --check \"patterns,coupling,cohesion,solid\" \\\n  --visualize-impact \\\n  --suggest-refactoring\n</code></pre>\n<details>\n<summary><strong>Architecture Analysis</strong></summary>\n<pre><code>{\n  \"patterns\": [\n    \"Design pattern adherence\",\n    \"SOLID principles\",\n    \"DRY violations\",\n    \"Separation of concerns\",\n    \"Dependency injection\",\n    \"Layer violations\",\n    \"Circular dependencies\"\n  ],\n  \"metrics\": [\n    \"Coupling metrics\",\n    \"Cohesion scores\",\n    \"Complexity measures\",\n    \"Maintainability index\"\n  ]\n}\n</code></pre>\n</details>\n<hr>\n<h3>Style &amp; Convention Agent</h3>\n<p><strong>Focus:</strong> Enforce coding standards and best practices</p>\n<pre><code># Style enforcement with auto-fix\nnpx ruv-swarm github review-style \\\n  --pr 123 \\\n  --check \"formatting,naming,docs,tests\" \\\n  --auto-fix \"formatting,imports,whitespace\"\n</code></pre>\n<details>\n<summary><strong>Style Checks</strong></summary>\n<pre><code>{\n  \"checks\": [\n    \"Code formatting\",\n    \"Naming conventions\",\n    \"Documentation standards\",\n    \"Comment quality\",\n    \"Test coverage\",\n    \"Error handling patterns\",\n    \"Logging standards\"\n  ],\n  \"auto-fix\": [\n    \"Formatting issues\",\n    \"Import organization\",\n    \"Trailing whitespace\",\n    \"Simple naming issues\"\n  ]\n}\n</code></pre>\n</details>\n<hr>\n<h2>\uD83D\uDD04 PR-Based Swarm Management</h2>\n<h3>Create Swarm from PR</h3>\n<pre><code># Create swarm from PR description using gh CLI\ngh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr\n\n# Auto-spawn agents based on PR labels\ngh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn\n\n# Create swarm with full PR context\ngh pr view 123 --json body,labels,author,assignees | \\\n  npx ruv-swarm swarm init --from-pr-data\n</code></pre>\n<h3>Label-Based Agent Assignment</h3>\n<p>Map PR labels to specialized agents:</p>\n<pre><code>{\n  \"label-mapping\": {\n    \"bug\": [\"debugger\", \"tester\"],\n    \"feature\": [\"architect\", \"coder\", \"tester\"],\n    \"refactor\": [\"analyst\", \"coder\"],\n    \"docs\": [\"researcher\", \"writer\"],\n    \"performance\": [\"analyst\", \"optimizer\"],\n    \"security\": [\"security\", \"authentication\", \"audit\"]\n  }\n}\n</code></pre>\n<h3>Topology Selection by PR Size</h3>\n<pre><code># Automatic topology selection based on PR complexity\n# Small PR (&lt; 100 lines): ring topology\n# Medium PR (100-500 lines): mesh topology\n# Large PR (&gt; 500 lines): hierarchical topology\nnpx ruv-swarm github pr-topology --pr 123\n</code></pre>\n<hr>\n<h2>\uD83C\uDFAC PR Comment Commands</h2>\n<p>Execute swarm commands directly from PR comments:</p>\n<pre><code>&lt;!-- In PR comment --&gt;\n/swarm init mesh 6\n/swarm spawn coder \"Implement authentication\"\n/swarm spawn tester \"Write unit tests\"\n/swarm status\n/swarm review --agents security,performance\n</code></pre>\n<details>\n<summary><strong>Webhook Handler for Comment Commands</strong></summary>\n<pre><code>// webhook-handler.js\nconst { createServer } = require('http');\nconst { execSync } = require('child_process');\n\ncreateServer((req, res) =&gt; {\n  if (req.url === '/github-webhook') {\n    const event = JSON.parse(body);\n\n    if (event.action === 'opened' &amp;&amp; event.pull_request) {\n      execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);\n    }\n\n    if (event.comment &amp;&amp; event.comment.body.startsWith('/swarm')) {\n      const command = event.comment.body;\n      execSync(`npx ruv-swarm github handle-comment --pr ${event.issue.number} --command \"${command}\"`);\n    }\n\n    res.writeHead(200);\n    res.end('OK');\n  }\n}).listen(3000);\n</code></pre>\n</details>\n<hr>\n<h2>⚙️ Review Configuration</h2>\n<h3>Configuration File</h3>\n<pre><code># .github/review-swarm.yml\nversion: 1\nreview:\n  auto-trigger: true\n  required-agents:\n    - security\n    - performance\n    - style\n  optional-agents:\n    - architecture\n    - accessibility\n    - i18n\n\n  thresholds:\n    security: block      # Block merge on security issues\n    performance: warn    # Warn on performance issues\n    style: suggest       # Suggest style improvements\n\n  rules:\n    security:\n      - no-eval\n      - no-hardcoded-secrets\n      - proper-auth-checks\n      - validate-input\n    performance:\n      - no-n-plus-one\n      - efficient-queries\n      - proper-caching\n      - optimize-loops\n    architecture:\n      - max-coupling: 5\n      - min-cohesion: 0.7\n      - follow-patterns\n      - avoid-circular-deps\n</code></pre>\n<h3>Custom Review Triggers</h3>\n<pre><code>{\n  \"triggers\": {\n    \"high-risk-files\": {\n      \"paths\": [\"**/auth/**\", \"**/payment/**\", \"**/admin/**\"],\n      \"agents\": [\"security\", \"architecture\"],\n      \"depth\": \"comprehensive\",\n      \"require-approval\": true\n    },\n    \"performance-critical\": {\n      \"paths\": [\"**/api/**\", \"**/database/**\", \"**/cache/**\"],\n      \"agents\": [\"performance\", \"database\"],\n      \"benchmarks\": true,\n      \"regression-threshold\": \"5%\"\n    },\n    \"ui-changes\": {\n      \"paths\": [\"**/components/**\", \"**/styles/**\", \"**/pages/**\"],\n      \"agents\": [\"accessibility\", \"style\", \"i18n\"],\n      \"visual-tests\": true,\n      \"responsive-check\": true\n    }\n  }\n}\n</code></pre>\n<hr>\n<h2>\uD83E\uDD16 Automated Workflows</h2>\n<h3>Auto-Review on PR Creation</h3>\n<pre><code># .github/workflows/auto-review.yml\nname: Automated Code Review\non:\n  pull_request:\n    types: [opened, synchronize]\n  issue_comment:\n    types: [created]\n\njobs:\n  swarm-review:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n        with:\n          fetch-depth: 0\n\n      - name: Setup GitHub CLI\n        run: echo \"${{ secrets.GITHUB_TOKEN }}\" | gh auth login --with-token\n\n      - name: Run Review Swarm\n        run: |\n          # Get PR context with gh CLI\n          PR_NUM=${{ github.event.pull_request.number }}\n          PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)\n          PR_DIFF=$(gh pr diff $PR_NUM)\n\n          # Run swarm review\n          REVIEW_OUTPUT=$(npx ruv-swarm github review-all \\\n            --pr $PR_NUM \\\n            --pr-data \"$PR_DATA\" \\\n            --diff \"$PR_DIFF\" \\\n            --agents \"security,performance,style,architecture\")\n\n          # Post review results\n          echo \"$REVIEW_OUTPUT\" | gh pr review $PR_NUM --comment -F -\n\n          # Update PR status\n          if echo \"$REVIEW_OUTPUT\" | grep -q \"approved\"; then\n            gh pr review $PR_NUM --approve\n          elif echo \"$REVIEW_OUTPUT\" | grep -q \"changes-requested\"; then\n            gh pr review $PR_NUM --request-changes -b \"See review comments above\"\n          fi\n\n      - name: Update Labels\n        run: |\n          # Add labels based on review results\n          if echo \"$REVIEW_OUTPUT\" | grep -q \"security\"; then\n            gh pr edit $PR_NUM --add-label \"security-review\"\n          fi\n          if echo \"$REVIEW_OUTPUT\" | grep -q \"performance\"; then\n            gh pr edit $PR_NUM --add-label \"performance-review\"\n          fi\n</code></pre>\n<hr>\n<h2>\uD83D\uDCAC Intelligent Comment Generation</h2>\n<h3>Generate Contextual Review Comments</h3>\n<pre><code># Get PR diff with context\nPR_DIFF=$(gh pr diff 123 --color never)\nPR_FILES=$(gh pr view 123 --json files)\n\n# Generate review comments\nCOMMENTS=$(npx ruv-swarm github review-comment \\\n  --pr 123 \\\n  --diff \"$PR_DIFF\" \\\n  --files \"$PR_FILES\" \\\n  --style \"constructive\" \\\n  --include-examples \\\n  --suggest-fixes)\n\n# Post comments using gh CLI\necho \"$COMMENTS\" | jq -c '.[]' | while read -r comment; do\n  FILE=$(echo \"$comment\" | jq -r '.path')\n  LINE=$(echo \"$comment\" | jq -r '.line')\n  BODY=$(echo \"$comment\" | jq -r '.body')\n  COMMIT_ID=$(gh pr view 123 --json headRefOid -q .headRefOid)\n\n  # Create inline review comments\n  gh api \\\n    --method POST \\\n    /repos/:owner/:repo/pulls/123/comments \\\n    -f path=\"$FILE\" \\\n    -f line=\"$LINE\" \\\n    -f body=\"$BODY\" \\\n    -f commit_id=\"$COMMIT_ID\"\ndone\n</code></pre>\n<h3>Batch Comment Management</h3>\n<pre><code># Manage review comments efficiently\nnpx ruv-swarm github review-comments \\\n  --pr 123 \\\n  --group-by \"agent,severity\" \\\n  --summarize \\\n  --resolve-outdated\n</code></pre>\n<hr>\n<h2>\uD83D\uDEAA Quality Gates &amp; Checks</h2>\n<h3>Status Checks</h3>\n<pre><code># Required status checks in branch protection\nprotection_rules:\n  required_status_checks:\n    strict: true\n    contexts:\n      - \"review-swarm/security\"\n      - \"review-swarm/performance\"\n      - \"review-swarm/architecture\"\n      - \"review-swarm/tests\"\n</code></pre>\n<h3>Define Quality Gates</h3>\n<pre><code># Set quality gate thresholds\nnpx ruv-swarm github quality-gates \\\n  --define '{\n    \"security\": {\"threshold\": \"no-critical\"},\n    \"performance\": {\"regression\": \"&lt;5%\"},\n    \"coverage\": {\"minimum\": \"80%\"},\n    \"architecture\": {\"complexity\": \"&lt;10\"},\n    \"duplication\": {\"maximum\": \"5%\"}\n  }'\n</code></pre>\n<h3>Track Review Metrics</h3>\n<pre><code># Monitor review effectiveness\nnpx ruv-swarm github review-metrics \\\n  --period 30d \\\n  --metrics \"issues-found,false-positives,fix-rate,time-to-review\" \\\n  --export-dashboard \\\n  --format json\n</code></pre>\n<hr>\n<h2>\uD83C\uDF93 Advanced Features</h2>\n<h3>Context-Aware Reviews</h3>\n<p>Analyze PRs with full project context:</p>\n<pre><code># Review with comprehensive context\nnpx ruv-swarm github review-context \\\n  --pr 123 \\\n  --load-related-prs \\\n  --analyze-impact \\\n  --check-breaking-changes \\\n  --dependency-analysis\n</code></pre>\n<h3>Learning from History</h3>\n<p>Train review agents on your codebase patterns:</p>\n<pre><code># Learn from past reviews\nnpx ruv-swarm github review-learn \\\n  --analyze-past-reviews \\\n  --identify-patterns \\\n  --improve-suggestions \\\n  --reduce-false-positives\n\n# Train on your codebase\nnpx ruv-swarm github review-train \\\n  --learn-patterns \\\n  --adapt-to-style \\\n  --improve-accuracy\n</code></pre>\n<h3>Cross-PR Analysis</h3>\n<p>Coordinate reviews across related pull requests:</p>\n<pre><code># Analyze related PRs together\nnpx ruv-swarm github review-batch \\\n  --prs \"123,124,125\" \\\n  --check-consistency \\\n  --verify-integration \\\n  --combined-impact\n</code></pre>\n<h3>Multi-PR Swarm Coordination</h3>\n<pre><code># Coordinate swarms across related PRs\nnpx ruv-swarm github multi-pr \\\n  --prs \"123,124,125\" \\\n  --strategy \"parallel\" \\\n  --share-memory\n</code></pre>\n<hr>\n<h2>\uD83D\uDEE0️ Custom Review Agents</h2>\n<h3>Create Custom Agent</h3>\n<pre><code>// custom-review-agent.js\nclass CustomReviewAgent {\n  constructor(config) {\n    this.config = config;\n    this.rules = config.rules || [];\n  }\n\n  async review(pr) {\n    const issues = [];\n\n    // Custom logic: Check for TODO comments in production code\n    if (await this.checkTodoComments(pr)) {\n      issues.push({\n        severity: 'warning',\n        file: pr.file,\n        line: pr.line,\n        message: 'TODO comment found in production code',\n        suggestion: 'Resolve TODO or create issue to track it'\n      });\n    }\n\n    // Custom logic: Verify API versioning\n    if (await this.checkApiVersioning(pr)) {\n      issues.push({\n        severity: 'error',\n        file: pr.file,\n        line: pr.line,\n        message: 'API endpoint missing versioning',\n        suggestion: 'Add /v1/, /v2/ prefix to API routes'\n      });\n    }\n\n    return issues;\n  }\n\n  async checkTodoComments(pr) {\n    // Implementation\n    const todoRegex = /\\/\\/\\s*TODO|\\/\\*\\s*TODO/gi;\n    return todoRegex.test(pr.diff);\n  }\n\n  async checkApiVersioning(pr) {\n    // Implementation\n    const apiRegex = /app\\.(get|post|put|delete)\\(['\"]\\/api\\/(?!v\\d+)/;\n    return apiRegex.test(pr.diff);\n  }\n}\n\nmodule.exports = CustomReviewAgent;\n</code></pre>\n<h3>Register Custom Agent</h3>\n<pre><code># Register custom review agent\nnpx ruv-swarm github register-agent \\\n  --name \"custom-reviewer\" \\\n  --file \"./custom-review-agent.js\" \\\n  --category \"standards\"\n</code></pre>\n<hr>\n<h2>\uD83D\uDD27 CI/CD Integration</h2>\n<h3>Integration with Build Pipeline</h3>\n<pre><code># .github/workflows/build-and-review.yml\nname: Build and Review\non: [pull_request]\n\njobs:\n  build-and-test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n      - run: npm install\n      - run: npm test\n      - run: npm run build\n\n  swarm-review:\n    needs: build-and-test\n    runs-on: ubuntu-latest\n    steps:\n      - name: Run Swarm Review\n        run: |\n          npx ruv-swarm github review-all \\\n            --pr ${{ github.event.pull_request.number }} \\\n            --include-build-results\n</code></pre>\n<h3>Automated PR Fixes</h3>\n<pre><code># Auto-fix common issues\nnpx ruv-swarm github pr-fix 123 \\\n  --issues \"lint,test-failures,formatting\" \\\n  --commit-fixes \\\n  --push-changes\n</code></pre>\n<h3>Progress Updates to PR</h3>\n<pre><code># Post swarm progress to PR using gh CLI\nPROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)\n\ngh pr comment 123 --body \"$PROGRESS\"\n\n# Update PR labels based on progress\nif [[ $(echo \"$PROGRESS\" | grep -o '[0-9]\\+%' | sed 's/%//') -gt 90 ]]; then\n  gh pr edit 123 --add-label \"ready-for-review\"\nfi\n</code></pre>\n<hr>\n<h2>\uD83D\uDCCB Complete Workflow Examples</h2>\n<h3>Example 1: Security-Critical PR</h3>\n<pre><code># Review authentication system changes\nnpx ruv-swarm github review-init \\\n  --pr 456 \\\n  --agents \"security,authentication,audit\" \\\n  --depth \"maximum\" \\\n  --require-security-approval \\\n  --penetration-test\n</code></pre>\n<h3>Example 2: Performance-Sensitive PR</h3>\n<pre><code># Review database optimization\nnpx ruv-swarm github review-init \\\n  --pr 789 \\\n  --agents \"performance,database,caching\" \\\n  --benchmark \\\n  --profile \\\n  --load-test\n</code></pre>\n<h3>Example 3: UI Component PR</h3>\n<pre><code># Review new component library\nnpx ruv-swarm github review-init \\\n  --pr 321 \\\n  --agents \"accessibility,style,i18n,docs\" \\\n  --visual-regression \\\n  --component-tests \\\n  --responsive-check\n</code></pre>\n<h3>Example 4: Feature Development PR</h3>\n<pre><code># Review new feature implementation\ngh pr view 456 --json body,labels,files | \\\n  npx ruv-swarm github pr-init 456 \\\n    --topology hierarchical \\\n    --agents \"architect,coder,tester,security\" \\\n    --auto-assign-tasks\n</code></pre>\n<h3>Example 5: Bug Fix PR</h3>\n<pre><code># Review bug fix with debugging focus\nnpx ruv-swarm github pr-init 789 \\\n  --topology mesh \\\n  --agents \"debugger,analyst,tester\" \\\n  --priority high \\\n  --regression-test\n</code></pre>\n<hr>\n<h2>\uD83D\uDCCA Monitoring &amp; Analytics</h2>\n<h3>Review Dashboard</h3>\n<pre><code># Launch real-time review dashboard\nnpx ruv-swarm github review-dashboard \\\n  --real-time \\\n  --show \"agent-activity,issue-trends,fix-rates,coverage\"\n</code></pre>\n<h3>Generate Review Reports</h3>\n<pre><code># Create comprehensive review report\nnpx ruv-swarm github review-report \\\n  --format \"markdown\" \\\n  --include \"summary,details,trends,recommendations\" \\\n  --email-stakeholders \\\n  --export-pdf\n</code></pre>\n<h3>PR Swarm Analytics</h3>\n<pre><code># Generate PR-specific analytics\nnpx ruv-swarm github pr-report 123 \\\n  --metrics \"completion-time,agent-efficiency,token-usage,issue-density\" \\\n  --format markdown \\\n  --compare-baseline\n</code></pre>\n<h3>Export to GitHub Insights</h3>\n<pre><code># Export metrics to GitHub Insights\nnpx ruv-swarm github export-metrics \\\n  --pr 123 \\\n  --to-insights \\\n  --dashboard-url\n</code></pre>\n<hr>\n<h2>\uD83D\uDD10 Security Considerations</h2>\n<h3>Best Practices</h3>\n<ol>\n<li><strong>Token Permissions</strong>: Ensure GitHub tokens have minimal required scopes</li>\n<li><strong>Command Validation</strong>: Validate all PR comments before execution</li>\n<li><strong>Rate Limiting</strong>: Implement rate limits for PR operations</li>\n<li><strong>Audit Trail</strong>: Log all swarm operations for compliance</li>\n<li><strong>Secret Management</strong>: Never expose API keys in PR comments or logs</li>\n</ol>\n<h3>Security Checklist</h3>\n<ul>\n<li><input disabled=\"disabled\" type=\"checkbox\"> GitHub token scoped to repository only</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Webhook signatures verified</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Command injection protection enabled</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Rate limiting configured</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Audit logging enabled</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Secrets scanning active</li>\n<li><input disabled=\"disabled\" type=\"checkbox\"> Branch protection rules enforced</li>\n</ul>\n<hr>\n<h2>\uD83D\uDCDA Best Practices</h2>\n<h3>1. Review Configuration</h3>\n<ul>\n<li>✅ Define clear review criteria upfront</li>\n<li>✅ Set appropriate severity thresholds</li>\n<li>✅ Configure agent specializations for your stack</li>\n<li>✅ Establish override procedures for emergencies</li>\n</ul>\n<h3>2. Comment Quality</h3>\n<ul>\n<li>✅ Provide actionable, specific feedback</li>\n<li>✅ Include code examples with suggestions</li>\n<li>✅ Reference documentation and best practices</li>\n<li>✅ Maintain respectful, constructive tone</li>\n</ul>\n<h3>3. Performance Optimization</h3>\n<ul>\n<li>✅ Cache analysis results to avoid redundant work</li>\n<li>✅ Use incremental reviews for large PRs</li>\n<li>✅ Enable parallel agent execution</li>\n<li>✅ Batch comment operations efficiently</li>\n</ul>\n<h3>4. PR Templates</h3>\n<pre><code>&lt;!-- .github/pull_request_template.md --&gt;\n## Swarm Configuration\n- Topology: [mesh/hierarchical/ring/star]\n- Max Agents: [number]\n- Auto-spawn: [yes/no]\n- Priority: [high/medium/low]\n\n## Tasks for Swarm\n- [ ] Task 1 description\n- [ ] Task 2 description\n- [ ] Task 3 description\n\n## Review Focus Areas\n- [ ] Security review\n- [ ] Performance analysis\n- [ ] Architecture validation\n- [ ] Accessibility check\n</code></pre>\n<h3>5. Auto-Merge When Ready</h3>\n<pre><code># Auto-merge when swarm completes and passes checks\nSWARM_STATUS=$(npx ruv-swarm github pr-status 123)\n\nif [[ \"$SWARM_STATUS\" == \"complete\" ]]; then\n  # Check review requirements\n  REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')\n\n  if [[ $REVIEWS -ge 2 ]]; then\n    # Enable auto-merge\n    gh pr merge 123 --auto --squash\n  fi\nfi\n</code></pre>\n<hr>\n<h2>\uD83D\uDD17 Integration with Claude Code</h2>\n<h3>Workflow Pattern</h3>\n<ol>\n<li><strong>Claude Code</strong> reads PR diff and context</li>\n<li><strong>Swarm</strong> coordinates review approach based on PR type</li>\n<li><strong>Agents</strong> work in parallel on different review aspects</li>\n<li><strong>Progress</strong> updates posted to PR automatically</li>\n<li><strong>Final review</strong> performed before marking ready</li>\n</ol>\n<h3>Example: Complete PR Management</h3>\n<pre><code>[Single Message - Parallel Execution]:\n  // Initialize coordination\n  mcp__claude-flow__swarm_init { topology: \"hierarchical\", maxAgents: 5 }\n  mcp__claude-flow__agent_spawn { type: \"reviewer\", name: \"Senior Reviewer\" }\n  mcp__claude-flow__agent_spawn { type: \"tester\", name: \"QA Engineer\" }\n  mcp__claude-flow__agent_spawn { type: \"coordinator\", name: \"Merge Coordinator\" }\n\n  // Create and manage PR using gh CLI\n  Bash(\"gh pr create --title 'Feature: Add authentication' --base main\")\n  Bash(\"gh pr view 54 --json files,diff\")\n  Bash(\"gh pr review 54 --approve --body 'LGTM after automated review'\")\n\n  // Execute tests and validation\n  Bash(\"npm test\")\n  Bash(\"npm run lint\")\n  Bash(\"npm run build\")\n\n  // Track progress\n  TodoWrite { todos: [\n    { content: \"Complete code review\", status: \"completed\", activeForm: \"Completing code review\" },\n    { content: \"Run test suite\", status: \"completed\", activeForm: \"Running test suite\" },\n    { content: \"Validate security\", status: \"completed\", activeForm: \"Validating security\" },\n    { content: \"Merge when ready\", status: \"pending\", activeForm: \"Merging when ready\" }\n  ]}\n</code></pre>\n<hr>\n<h2>\uD83C\uDD98 Troubleshooting</h2>\n<h3>Common Issues</h3>\n<details>\n<summary><strong>Issue: Review agents not spawning</strong></summary>\n<p><strong>Solution:</strong></p>\n<pre><code># Check swarm status\nnpx ruv-swarm swarm-status\n\n# Verify GitHub CLI authentication\ngh auth status\n\n# Re-initialize swarm\nnpx ruv-swarm github review-init --pr 123 --force\n</code></pre>\n</details>\n<details>\n<summary><strong>Issue: Comments not posting to PR</strong></summary>\n<p><strong>Solution:</strong></p>\n<pre><code># Verify GitHub token permissions\ngh auth status\n\n# Check API rate limits\ngh api rate_limit\n\n# Use batch comment posting\nnpx ruv-swarm github review-comments --pr 123 --batch\n</code></pre>\n</details>\n<details>\n<summary><strong>Issue: Review taking too long</strong></summary>\n<p><strong>Solution:</strong></p>\n<pre><code># Use incremental review for large PRs\nnpx ruv-swarm github review-init --pr 123 --incremental\n\n# Reduce agent count\nnpx ruv-swarm github review-init --pr 123 --agents \"security,style\" --max-agents 3\n\n# Enable parallel processing\nnpx ruv-swarm github review-init --pr 123 --parallel --cache-results\n</code></pre>\n</details>\n<hr>\n<h2>\uD83D\uDCD6 Additional Resources</h2>\n<h3>Related Skills</h3>\n<ul>\n<li><code>github-pr-manager</code> - Comprehensive PR lifecycle management</li>\n<li><code>github-workflow-automation</code> - Automate GitHub workflows</li>\n<li><code>swarm-coordination</code> - Advanced swarm orchestration</li>\n</ul>\n<h3>Documentation</h3>\n<ul>\n<li><a href=\"https://cli.github.com/manual/\">GitHub CLI Documentation</a></li>\n<li><a href=\"https://github.com/ruvnet/ruv-swarm\">RUV Swarm Guide</a></li>\n<li><a href=\"https://github.com/ruvnet/claude-flow\">Claude Flow Integration</a></li>\n</ul>\n<h3>Support</h3>\n<ul>\n<li>GitHub Issues: Report bugs and request features</li>\n<li>Community: Join discussions and share experiences</li>\n<li>Examples: Browse example configurations and workflows</li>\n</ul>\n<hr>\n<h2>\uD83D\uDCC4 License</h2>\n<p>This skill is part of the Claude Code Flow project and is licensed under the MIT License.</p>\n<hr>\n<p><strong>Last Updated:</strong> 2025-10-19\n<strong>Version:</strong> 1.0.0\n<strong>Maintainer:</strong> Claude Code Flow Team</p>\n</details>","files":[{"path":"SKILL.md","sizeBytes":26048,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-31T17:35:16.176009Z","sha256":"E448ACE31BAA42F92CAF2631D7D5D2876774020FB8004665C9954276C4EBBA61","sizeBytes":8784},"review":null,"source":{"repositoryUrl":"https://github.com/spencermarx/open-code-review","path":".claude/skills/github-code-review","license":"Apache-2.0","commit":"373a6c340312c86a6b42ded368f86f12570c34c5","subtreeSha":"83B60A1F65CB42AFF644CC755DC2D3F28A241F8EA08D0E277A66E9E7374A6E71","lastSyncedAt":"2026-11-19T20:53:19.287432Z"},"reviewedAt":"2026-10-31T17:35:34.293221Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/spencermarx/open-code-review/tree/main/.claude/skills/github-code-review"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install spencermarx-open-code-review@llmmart"},{"target":"git","command":"git clone https://github.com/spencermarx/open-code-review.git"}]}