dvelton/first-knock
Contributor context for new PRs. Surfaces account, engagement, commit, and activity data to help maintainers review contributions from new contributors.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| github-token | GitHub token for API access. Defaults to the automatic GITHUB_TOKEN. | no | ${{ github.token }} |
| mode | Operating mode. "context-card" (default): Analyze the PR author and post a context card. "challenge-monitor": Monitor for challenge responses on issue_comment or schedule events. | no | context-card |
| enable-account | Enable account profile analysis. | no | true |
| enable-engagement | Enable prior repo engagement analysis. | no | true |
| enable-forensics | Enable commit metadata analysis. | no | true |
| enable-velocity | Enable cross-repo activity analysis. | no | true |
| enable-similarity | Enable PR description / issue body similarity analysis. | no | true |
| challenge-enabled | Post a follow-up question asking the contributor to describe their change. | no | false |
| challenge-prompt | Custom text for the challenge question. | no | Thanks for your contribution! To help us review this, could you share what prompted this change and how you verified it works? |
| challenge-auto-close-days | Automatically close PRs with no challenge response after this many days. Set to 0 to disable. | no | 0 |
| challenge-label-no-response | Label applied to PRs with a pending challenge. Removed when the contributor responds. | no | needs-response |
| skip-accounts | Comma-separated list of accounts to skip (in addition to built-in bot accounts like dependabot). | no | "" |
| skip-org-members | Skip context cards for organization members. | no | true |
| custom-footer | Custom footer text for the context card. Replaces the default attribution. | no | "" |
Outputs
| name | description |
|---|---|
| context-card-posted | Whether a context card was posted (true/false). |
| is-first-interaction | Whether this is the contributor's first interaction with the repo. |
| account-age-days | Age of the contributor's GitHub account in days. |
| prs-last-7-days | Number of PRs the contributor has opened across all repos in the last 7 days. |