# Github Stars Management

> Organize GitHub stars with AI using starred tool.

- Skill: `publieople/github-stars-management` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add publieople/github-stars-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/publieople/github-stars-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: publieople (https://skillmd.com/u/publieople)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/publieople/github-stars-management

---


# GitHub Stars Management

When user has 100s+ starred GitHub repos and wants AI to organize/categorize them.

## Decision: `amirhmoradi/starred`

After comparing 4 tools, **`starred`** is the recommended pick:

- **Python** — no extra runtime needed
- **Multi-provider** — Claude, GPT, or Gemini (auto-detects from available keys)
- **Free tier available** — Gemini 2.0 Flash is completely free
- **GitHub Actions** — set-and-forget, runs daily
- **Output** — `STARRED_REPOS.md` with TOC, categories, star counts + profile README integration

## Setup (GitHub Actions)

### 1. Fork

Fork https://github.com/amirhmoradi/starred

### 2. Create GH_PAT

https://github.com/settings/personal-access-tokens/new
**Required scope:** `starring:read` (NOT `repo` — won't work for stars API)

### 3. Add Repository Secrets

Settings → Secrets and variables → Actions → **Repository secrets** (not Environment secrets)

| Secret | Value | Required |
|--------|-------|----------|
| `GH_PAT` | PAT from step 2 | ✅ |
| `GEMINI_API_KEY` | From https://aistudio.google.com/apikey | Pick one |
| `ANTHROPIC_API_KEY` | From https://console.anthropic.com/ | Pick one |
| `OPENAI_API_KEY` | From https://platform.openai.com/api-keys | Pick one |

**Recommend Gemini** — free tier handles 800+ star classification at zero cost.

### 4. Run

Actions → "Update Starred Repos" → Run workflow. Result in `STARRED_REPOS.md`.

### 5. Ongoing

Workflow runs daily at 2 AM UTC. New stars auto-categorized.

## Provider Auto-Detection

Checks env vars in priority: `ANTHROPIC_API_KEY` → `OPENAI_API_KEY` → `GEMINI_API_KEY`. Only one key needed.

## Limitations

- **No custom base_url** — cannot use DeepSeek/OmniRoute. Three built-in providers only.
- **GitHub Lists sync** requires browser cookie (expires ~2 weeks).
- **Only public metadata** sent to AI (name, desc, language, README).

## Local CLI

```bash
git clone https://github.com/amirhmoradi/starred && cd starred
pip install -e ".[all]"
export GH_TOKEN=ghp_xxx GEMINI_API_KEY=***
starred fetch --username <user> --with-readme
starred categorize --provider gemini
```