feat: add Claude-powered PR review workflows

- Add claude-notebook-review.yml for intelligent code review
- Add claude-link-review.yml for link quality checks
- Update notebook-quality.yml to properly capture test outputs
- Use anthropics/claude-code-action@beta like docs repo

Author: zealoushacker

.github/workflows/claude-link-review.yml

@@ -0,0 +1,59 @@
+name: Claude Link Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - '**.md'
+      - '**.mdx'
+      - '**.ipynb'
+      - 'README.md'
+
+jobs:
+  link-review:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Claude Link Review
+        uses: anthropics/claude-code-action@beta
+        with:
+          use_sticky_comment: true
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          timeout_minutes: "30"
+          allowed_bots: "*"
+          direct_prompt: |
+            Review the links in the changed files and check for potential issues:
+
+            ## Link Quality Checks
+            1. **Broken Links**: Identify any links that might be broken or malformed
+            2. **Outdated Links**: Check for links to deprecated resources or old documentation
+            3. **Security**: Ensure no links to suspicious or potentially harmful sites
+            4. **Best Practices**: 
+               - Links should use HTTPS where possible
+               - Internal links should use relative paths
+               - External links should be to stable, reputable sources
+
+            ## Specific Checks for Anthropic Content
+            - Links to Claude documentation should point to the latest versions
+            - API documentation links should be current
+            - Model documentation should reference current models, not deprecated ones
+            - GitHub links should use the correct repository paths
+
+            ## Report Format
+            Provide a clear summary with:
+            - ✅ Valid and well-formed links
+            - ⚠️ Links that might need attention (e.g., HTTP instead of HTTPS)
+            - ❌ Broken or problematic links that must be fixed
+            
+            If all links look good, provide a brief confirmation.
+            
+            Format your response as a helpful PR review comment.

.github/workflows/claude-notebook-review.yml

@@ -0,0 +1,64 @@
+name: Claude Notebook Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - 'skills/**/*.ipynb'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'scripts/**/*.py'
+
+jobs:
+  notebook-review:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Claude Notebook Review
+        uses: anthropics/claude-code-action@beta
+        with:
+          use_sticky_comment: true
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          timeout_minutes: "30"
+          allowed_bots: "*"
+          direct_prompt: |
+            Review the changes to Jupyter notebooks and Python scripts in this PR. Please check for:
+
+            ## Model Usage
+            Check that all Claude model references use current, public models:
+            - claude-3-5-haiku-latest (recommended for testing)
+            - claude-3-5-sonnet-latest (for complex tasks)
+            - Avoid deprecated models like claude-3-haiku-20240307, old Sonnet 3.5 versions
+
+            ## Code Quality
+            - Python code follows PEP 8 conventions
+            - Proper error handling
+            - Clear variable names and documentation
+            - No hardcoded API keys (use os.getenv("ANTHROPIC_API_KEY"))
+
+            ## Notebook Structure
+            - Clear markdown explanations between code cells
+            - Logical flow from simple to complex
+            - Outputs preserved for educational value
+            - Dependencies properly imported
+
+            ## Security
+            - No exposed secrets or API keys
+            - Safe handling of user inputs
+            - Appropriate use of environment variables
+
+            Provide a clear summary with:
+            - ✅ What looks good
+            - ⚠️ Suggestions for improvement
+            - ❌ Critical issues that must be fixed
+
+            Format your response as a helpful PR review comment.

.github/workflows/notebook-quality.yml

@@ -13,6 +13,7 @@ on:
 
 permissions:
   contents: read
+  pull-requests: write
 
 jobs:
   validate-notebooks:
@@ -59,14 +60,17 @@ jobs:
         env:
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         run: |
+          mkdir -p test_outputs
           for notebook in skills/*/guide.ipynb; do
             echo "📓 Testing: $notebook"
-            # Use nbconvert to execute notebooks
+            output_name=$(basename $(dirname "$notebook"))
+            # Use nbconvert to execute notebooks and save outputs
             uv run jupyter nbconvert --to notebook \
               --execute "$notebook" \
               --ExecutePreprocessor.kernel_name=python3 \
               --ExecutePreprocessor.timeout=120 \
-              --stdout > /dev/null \
+              --output "test_outputs/${output_name}_executed.ipynb" \
+              --output-dir=. \
               || echo "⚠️  Failed: $notebook"
           done
       
@@ -90,4 +94,4 @@ jobs:
         with:
           name: notebook-test-outputs-py${{ matrix.python-version }}
           path: test_outputs/
-          retention-days: 7
+          retention-days: 7