Schedule icon
Get icon
Script icon
If icon
SlackIncomingWebhook icon
Log icon
Set icon

Good First Issue Scout

Find open good-first-issue GitHub issues, rank by competition, and notify Slack every 12 hours.

Categories
Business

What this Blueprint does

Searches a GitHub repository for open issues labelled e.g. good first issue / help wanted, enriches each with assignees + commenter counts, assigns a 🟢/🟡/🔴 competition score, ranks the most promising first, and posts the top fresh picks to Slack. Runs every 12 hours.

Required credentials (Kestra secrets, never hardcoded)

  • GITHUB_TOKEN: GitHub PAT (classic public_repo scope is enough for public repos; full repo for private). Raises rate limits from 10 to 30 search req/min.
  • SLACK_WEBHOOK_URL: Slack incoming webhook URL for the digest and failure alerts.

How to configure

Inputs: repository (owner/repo), labels (comma-separated), max_issues (1-100, Search API page cap), max_age_days (stale issues filtered out), top_n (digest size), notify_slack (bool). Change the schedule by editing the every_12_hours cron (0 */12 * * *).

How to run

  1. Add the two secrets above to your namespace.
  2. Import this flow, set repository + labels, click Execute to test manually.
  3. Leave the schedule enabled for twice-daily runs.

What the competition score means

  • 🟢 Low: zero assignees and ≤2 comments, appears unassigned and quiet. Best chance, but not a guarantee, always read the thread.
  • 🟡 Medium: zero assignees with 3-6 comments, or light discussion, worth a look, may have competition.
  • 🔴 High: has assignees or >10 comments, likely taken or crowded; comment to ask before starting. Ranking: Low → Medium → High, then fewer assignees/comments, then more recent activity.

Example configuration

repository: kestra-io/kestra, labels: "good first issue,help wanted", max_issues: 30, max_age_days: 180, top_n: 5.

Example notification

🟢 Good First Issue Opportunity, Repository: owner/repo, Issue: Add XYZ validation, Comments: 2, Assignees: 0, Commenters: 2, Issue age: 3 days, Competition: Low + issue URL.

Links

See How

New to Kestra?

Use blueprints to kickstart your first workflows.