Skip to content

notque/vexjoy-agent / skills/process/pr-workflow

pr-workflow

Flagged

Pull request lifecycle: commit, codex review, sync, review, fix, status, cleanup, and PR mining. Use when user wants to commit changes, get a second-opinion code review from Codex, push changes, create a PR, check PR status, fix review comments, clean up branches after merge, or mine tribal knowledge from PR reviews. Use for "commit my changes", "codex review", "push my changes", "create a PR", "pr status", "fix PR comments", "clean up branches", "mine PRs", or "address feedback".

scripts/validate.py

View on GitHub
#!/usr/bin/env python3
"""
Validate pr-miner skill setup
"""

import os
import sys
from pathlib import Path


def check_command(command: str) -> bool:
    """Check if a command is available"""
    import shutil

    return shutil.which(command) is not None


def check_python_package(package: str) -> bool:
    """Check if Python package is installed"""
    try:
        __import__(package)
        return True
    except ImportError:
        return False


def check_file(file_path: Path, description: str) -> bool:
    """Check if a file exists"""
    exists = file_path.exists()
    status = "✓" if exists else "✗"
    print(f"{status} {description}: {file_path}")
    return exists


def check_github_token() -> bool:
    """Check if GitHub token is available"""
    token = os.environ.get("GITHUB_TOKEN")
    if token:
        print(f"✓ GITHUB_TOKEN is set (length: {len(token)})")
        return True

    token_file = Path.home() / ".github-token"
    if token_file.exists():
        token = token_file.read_text().strip()
        print(f"✓ GitHub token found in ~/.github-token (length: {len(token)})")
        return True

    print("✗ GitHub token not found")
    print("  Set GITHUB_TOKEN or create ~/.github-token")
    return False


def main():
    print("=" * 70)
    print("PR Miner - Skill Validation")
    print("=" * 70)

    skill_dir = Path(__file__).parent.parent
    all_good = True

    # Check Python
    print("\nChecking Python environment:")
    if not check_command("python3"):
        print("✗ python3 is NOT installed")
        all_good = False
    else:
        print("✓ python3 is installed")

    # Check PyGithub
    print("\nChecking Python packages:")
    if not check_python_package("github"):
        print("✗ PyGithub is NOT installed")
        print("  Run: pip install PyGithub")
        all_good = False
    else:
        print("✓ PyGithub is installed")

    # Check GitHub token
    print("\nChecking GitHub authentication:")
    if not check_github_token():
        all_good = False

    # Check skill files
    print("\nChecking skill files:")
    check_file(skill_dir / "SKILL.md", "SKILL.md")
    check_file(skill_dir / "scripts" / "miner.py", "miner.py")
    check_file(skill_dir / "references", "references directory")

    # Summary
    print("\n" + "=" * 70)
    if all_good:
        print("✓ Skill validation PASSED")
        print("Ready to mine PRs!")
        return 0
    else:
        print("✗ Skill validation FAILED")
        print("Please install missing dependencies:")
        print("  - Python 3.7+")
        print("  - PyGithub: pip install PyGithub")
        print("  - GitHub token: Set GITHUB_TOKEN or create ~/.github-token")
        return 1


if __name__ == "__main__":
    sys.exit(main())
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall