# github-traffic

Pulls traffic metrics, visitor referrers, and clone counts from GitHub. Stores snapshots locally and generates trend charts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3800 installs
- Author: zc277584121
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/github-traffic/SKILL.md
- Updated: 2026-08-28
- HTML: https://affpapa.org/en/nevibecode/skills/github-traffic

## What it does

The skill connects through the authenticated `gh` CLI to inspect traffic details: page visits, clone activity, referrer sources, and star counts. GitHub restricts traffic history to the previous 14 days. To bypass that window, the script appends records to persistent JSON files in `~/.github-traffic/`. This accumulates data for 30-day or 90-day reports.

Visual reporting relies on `matplotlib`. It outputs PNG panels showing visitor volume, clones, and stars. If the library is missing, the tool generates plain ASCII charts inside the terminal.

Target repositories require write access. Read-only permissions trigger an HTTP 403 error from the GitHub API. Tracking third-party repositories will fail.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill github-traffic -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/github-traffic/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/github-traffic/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill github-traffic -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/github-traffic/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill github-traffic -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/github-traffic/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zc277584121/marketing-skills github-traffic
```

2. **Manually: put the files in place**
- File: `.github/skills/github-traffic/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill github-traffic -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/github-traffic
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/github-traffic/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill github-traffic -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/github-traffic/SKILL.md

## When to use it
- collect visitor views and clone activity for a repository
- preserve traffic data beyond the standard 14-day limit
- identify top external referral sources and popular paths
- render visual trend charts as PNG images or ASCII text

## Example prompts
- Show traffic stats and clone counts for `owner/repo`
- Generate a 30-day traffic trend chart for `owner/repo`
- Run a silent snapshot of `owner/repo` to update history

## Similar
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs
- [git-guardrails-claude-code](https://affpapa.org/en/nevibecode/skills/git-guardrails-claude-code.md) — skill · 499069 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [scaffold-exercises](https://affpapa.org/en/nevibecode/skills/scaffold-exercises.md) — skill · 480196 installs

From the same set: [zc277584121/marketing-skills](https://affpapa.org/en/nevibecode/by/zc277584121/marketing-skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md