Skip to content
Back to search

claude-bounty-skills

Claude Code skills and Python CLI tools to automate GitHub issue parsing, acceptance criteria checking, and PR generation for Algora and open-source bounties.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/i11usion88888888--claude-bounty-skills/badge.svg)](/listings/i11usion88888888--claude-bounty-skills)

HTML

<a href="/listings/i11usion88888888--claude-bounty-skills"><img src="/api/listings/i11usion88888888--claude-bounty-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Clone the repository:

git clone https://github.com/i11usion88888888/claude-bounty-skills.git
cd claude-bounty-skills

Install dependencies:

pip install -r requirements.txt

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 94 lines
  1. # Claude Bounty Skills
  2. A set of [Claude Code](https://code.claude.com/docs/en/skills) skills and Python CLI tools for hunters who take paid bounties on [Algora](https://algora.io) and GitHub.
  3. Instead of re-reading the same issue and re-typing the same PR template every time, let Claude handle the boring parts.
  4. ## Features
  5. - **`parse-issue`** — fetches a GitHub issue and extracts its `- [ ]` acceptance criteria as JSON.
  6. - **`check-criteria`** — compares the criteria with what you completed; exits with code 1 if anything is missing.
  7. - **`generate-pr`** — builds a Markdown PR description: summary, changes, criteria, how to test.
  8. ## Prerequisites
  9. - Python 3.10+
  10. - Git
  11. - Optional: [Claude Code](https://code.claude.com) for the skills integration
  12. ## Installation
  13. Clone the repository:
  14. ```bash
  15. git clone https://github.com/i11usion88888888/claude-bounty-skills.git
  16. cd claude-bounty-skills
  17. ```
  18. Install dependencies:
  19. ```bash
  20. pip install -r requirements.txt
  21. ```
  22. ## Usage
  23. ### Option 1: With Claude Code (recommended)
  24. Open Claude Code in this folder. The skills in `.claude/skills/` are picked up automatically.
  25. You can simply ask Claude:
  26. - "Parse this issue: https://github.com/owner/repo/issues/123"
  27. - "Check if I missed any acceptance criteria"
  28. - "Generate a PR description for this branch"
  29. Or call the skills directly: `/parse-issue`, `/check-criteria`, `/generate-pr`.
  30. ### Option 2: Manual CLI
  31. If you prefer to run the Python scripts directly:
  32. **1. Parse an issue**
  33. ```bash
  34. python scripts/parse_issue.py https://github.com/owner/repo/issues/123 -o issue.json
  35. ```
  36. **2. Check your progress** (after making changes)
  37. ```bash
  38. python scripts/check_criteria.py issue.json --done "Fixed bug" --done "Added tests"
  39. ```
  40. > **Note:** matching is case-insensitive. If any criterion is still open, the script exits with code 1.
  41. **3. Generate the PR description**
  42. ```bash
  43. python scripts/generate_pr.py issue.json --branch main
  44. ```
  45. Copy the output and paste it into your pull request on GitHub.
  46. ## Rate limits
  47. Without a token, GitHub allows 60 API requests per hour. If you hit the limit, set a `GITHUB_TOKEN` environment variable:
  48. ```bash
  49. export GITHUB_TOKEN=ghp_xxx # bash
  50. ```
  51. ```powershell
  52. $env:GITHUB_TOKEN = "ghp_xxx" # PowerShell
  53. ```
  54. ## Limitations
  55. - Only checkboxes written as `- [ ]` / `- [x]` are parsed.
  56. - GitHub only (no GitLab or Bitbucket support yet).
  57. - MVP: no unit tests or CI pipelines.
  58. ## License
  59. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.