Przejdź do treści
Biblioteka skilli
Dane i analityka · Integracja z narzędziem

github-api-queries

/github-api-queries

Odpytuje GitHub API o pull requesty i zgłoszenia z zakresu dat i pobiera wszystkie metadane potrzebne do zbierania metryk, na przykład w raportach aktywności.

Licencja
MIT
Ostatnia zmiana repozytorium
02.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 02.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Odpytuje GitHub API o pull requesty i zgłoszenia z zakresu dat i pobiera wszystkie metadane potrzebne do zbierania metryk, na przykład w raportach aktywności.

Oryginalny opis (EN)

Query GitHub API for pull requests and issues within a date range, retrieving all metadata needed for metrics collection. Use this skill whenever you need to fetch GitHub PR or issue data with date filtering, especially when gathering activity reports or computing statistics across a time period.

Jak działa

  1. Prerequisites
  2. Querying Pull Requests
  3. Querying Issues
  4. Error Handling
  5. Output Format
  6. Date Format
  7. Tips for Reliability
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 406 słów
Podgląd SKILL.md
---
name: github-api-queries
description: Query GitHub API for pull requests and issues within a date range, retrieving all metadata needed for metrics collection. Use this skill whenever you need to fetch GitHub PR or issue data with date filtering, especially when gathering activity reports or computing statistics across a time period.
---

# GitHub API Queries for Metrics Collection

This skill demonstrates how to query the GitHub API for pull requests and issues using the `gh` CLI tool, extracting all necessary metadata for downstream analysis.

## Prerequisites

- `gh` CLI installed and authenticated to GitHub
- Target repository in the format `owner/repo` (e.g., `cli/cli`)
- Date range for filtering (e.g., `2024-12-01..2024-12-31`)

## Querying Pull Requests

Use `gh pr list` with date filtering to retrieve all PRs created during a period:

```bash
gh pr list --repo cli/cli \
  --state all \
  --search "created:2024-12-01..2024-12-31" \
  --json number,title,author,createdAt,mergedAt,closedAt,state \
  --limit 1000
```

**Key flags:**
- `--state all`: Includes both open and closed PRs
- `--search "created:2024-12-01..2024-12-31"`: GitHub search syntax for date ranges
- `--json`: Specify exact fields needed (number, author, timestamps, state)
- `--limit 1000`: Fetch up to 1000 results (pagination handled by `gh`)

**Important fields for metrics:**
- `number`: PR identifier
- `author`: Object with `login` field for contributor tracking
- `createdAt`: ISO timestamp for PR creation
- `mergedAt`: ISO timestamp for merge (null if not merged)
- `closedAt`: ISO timestamp for closure (null if still open)
- `state`: OPEN, CLOSED, or MERGED

## Querying Issues

Use `gh issue list` for issues:

```bash
gh issue list --repo cli/cli \
  --state all \
  --search "created:2024-12-01..2024-12-31" \
  --json number,title,labels,createdAt,closedAt,state \
  --limit 1000
```

**Key fields for metrics:**
- `labels`: Array of label objects with `name` field (use for bug detection)
- `closedAt`: Timestamp for closure (null if still open)

## Error Handling

If `gh` returns a rate limit error, wait and retry:
```bash
# Check remaining API quota
gh api rate_limit
```

If authentication fails, ensure:
```bash
gh auth status
```

## Output Format

Both queries return JSON arrays. Each item includes the fields specified in `--json`. Example PR object:

```json
{
  "number": 12345,
  "title": "Add feature X",
  "author": {
    "login": "octocat"
  },
  "createdAt": "2024-12-05T14:30:00Z",
  "mergedAt": "2024-12-10T16:45:00Z",
  "closedAt": null,
  "state": "MERGED"
}
```

## Date Format

All timestamps use ISO 8601 format (UTC). For calculations, parse with standard datetime libraries:
- Python: `datetime.fromisoformat()`
- JavaScript: `new Date()` or `Date.parse()`
- Bash: Convert via epoch for arithmetic

## Tips for Reliability

- Always use `--limit 1000` or higher to ensure all results are captured (verify count matches expectation)
- Dates must use `YYYY-MM-DD` format in search queries
- Include both endpoints of the range (results are inclusive of both dates)
- When comparing timestamps, ensure consistent timezone handling (all GitHub timestamps are UTC)

Wersje

W bazie nie ma innych skilli o nazwie github-api-queries.

Migawka bazy z 13.11.2026 · wersja paczki 8a3e360978d7 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100gh-activity-query
    Pobiera przez gh CLI aktywność repozytorium GitHub (pull requesty, zgłoszenia) z wybranego zakresu dat i liczy statystyki, takie jak liczby, czasy scalania i najaktywniejsi współautorzy.
  • 100gh-issue-analysis
    Pobiera i analizuje zgłoszenia repozytorium GitHub z zakresu dat: łączne liczby, rozpoznawanie błędów po etykietach i liczba rozwiązanych błędów do raportów o kondycji społeczności.
  • 95github
    Obsługuje GitHub przez gh CLI: issues, pull requesty, uruchomienia CI i złożone zapytania gh api, np. sprawdzenie statusu CI, tworzenie PR i listowanie zgłoszeń.
  • 100github
    Obsługuje GitHub przez gh CLI: zgłoszenia, pull requesty, przebiegi CI, code review i zapytania API, na przykład przy sprawdzaniu statusu PR lub logów uruchomień.
  • 100github-gh-cli
    Sprawdza przez gh CLI pull requesty, issues, uruchomienia workflow i dane API bez otwierania przeglądarki, z wynikiem w JSON.
  • 100date-range-analyzer
    Prawdopodobnie analizuje zakresy dat w ramach analityki danych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.