skills.rest
homeassistant-ai
homeassistant-aiOFFICIAL
Explore all skills by this author →
GitHub

contributors-update

Finds merged PR authors missing from README and updates the contributors list after approval.

4.6k|202|Updated Sep 14, 2025
Search Tags:#Git#gh CLI#Documentation#gitHub#contributors#ReadMe#Pull Requests
One-click install
npx skills add https://github.com/homeassistant-ai/ha-mcp --skill contributors-update
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: contributors-update
Source: https://github.com/homeassistant-ai/ha-mcp/tree/main/.claude/skills/contributors-update
Command: npx skills add https://github.com/homeassistant-ai/ha-mcp --skill contributors-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping a repository's README contributors list current requires manually cross-referencing merged pull requests against existing entries, which is tedious and easy to forget. This Skill automates the discovery of new contributors and safely applies the update with human approval.

Core Features & Use Cases

  • Cutoff-Based PR Discovery: Locates the last [contributors-updated] marker commit on master to compute a cutoff date, then queries GitHub for merged PRs since that date using the gh CLI.
  • Contributor Filtering: Excludes bot accounts, existing maintainers and contributors, and the repo owner, then drafts one-line descriptions from PR titles and context.
  • Approval-Gated Commit: Previews proposed README additions, waits for explicit user approval, then commits directly to master with a marker commit message after verifying only README.md changed.
  • Use Case: A maintainer runs this monthly to credit new community members in the ha-mcp README without manually auditing dozens of merged PRs.

Quick Start

Ask the assistant to find contributors who merged PRs recently but are missing from the README and update the contributors list.

Frequently Asked Questions about contributors-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find new GitHub contributors missing from my README?▼

List merged PRs since a cutoff date with the GitHub CLI, then compare author logins against the existing Contributors and Maintainers sections in the README. Filter out bot accounts and already-listed handles to get the new contributors.

How to list merged pull requests since a specific date with gh CLI?▼

Use gh pr list with --state merged and a --search filter like merged:>=YYYY-MM-DD, requesting JSON fields for number, title, author, and mergedAt. Pushing the date filter into the search ensures filtering happens before result limits apply.

Does this workflow require creating a pull request for README updates?▼

No, this documentation-only update qualifies for an exception allowing the approved README change to be committed directly to master. It still requires explicit user approval and verifies that README.md is the only staged change before pushing.

How does the skill avoid re-processing old contributors?▼

It searches origin/master history for the most recent commit containing the [contributors-updated] marker and uses that date minus one week as the cutoff. If no marker exists, it defaults to two months ago.

What happens if master changes before the commit is pushed?▼

The workflow pulls master again with --ff-only immediately before committing and verifies only README.md is staged. If master moved in a conflicting way, it stops, recomputes the additions, and requests approval again.

Related Skills

Explore More Software Engineering Skills→
cuemathcuemath

post-merge-cleanup

Switch to master, delete the feature branch, and pull latest changes.

Official
Basic
NVIDIANVIDIA
22.3k

nemoclaw-maintainer-release-notes

Drafts post-tag NemoClaw release announcements from GitHub tag, compare, and PR metadata.

Official
Advanced
openshift-engopenshift-eng

CodeRabbit Inheritance Scanner - Existing PR Check

Identifies open GitHub pull requests whose titles contain “CodeRabbit inheritance” and outputs their number, URL, and days open.

Official
Intermediate
HorusGoulHorusGoul
8

all-contributors

Automate All Contributors metadata and README contributor table updates.

Community
Intermediate