Animated GitHub contribution snake for your profile README, your repos, and your orgs

说明与用途

通过 GitHub Actions 自动生成并更新仓库 README 和组织页面的动画贡献图表。

问题

GitHub only provides contribution calendars for user accounts, not for repositories or organizations, making it hard to display activity on README or org pages.

结果

The repo README now displays an animated snake, heatmap, skyline, and activity summary that update nightly, improving visibility of recent contributions for both users and organizations.

工作流

• Add a workflow file .github/workflows/readme-showcase.yml that schedules nightly runs and allows manual trigger.
• Run the workflow once from the Actions tab to generate the SVGs and stats.json.
• Commit the generated files to the output branch via the action.
• Update the README to embed the activity SVG with a prefers‑color‑scheme source set for dark mode.
• The workflow continues to update the images nightly, keeping the chart current.

证据

GitHub keeps a contribution calendar for user accounts and nothing else. A repository doesn't have one, and neither does an organization.

来源

I wrote github-action-shares, a GitHub Action that builds the calendar itself and draws three animated SVGs from it.

来源

Add the workflow. Save this as .github/workflows/readme-showcase.yml

来源

Run the workflow once. After that the nightly schedule takes over.

来源