Agent skill

Pp GitHub

by mvanhorn in mvanhorn/printing-press-library

Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: find duplicate issues, who owes me reviews, what changed since the last…

Apache-2.0Auto-check: notesBackend & APIs

Install Pp GitHub

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-github .claude/skills/pp-github && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .claude/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .agents/skills && cp -r skills-src/cli-skills/pp-github .agents/skills/pp-github && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .agents/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/cli-skills/pp-github .cursor/skills/pp-github && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .cursor/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mvanhorn/printing-press-library.git --path cli-skills/pp-github

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/cli-skills/pp-github .gemini/skills/pp-github && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .gemini/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .github/skills && cp -r skills-src/cli-skills/pp-github .github/skills/pp-github && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .github/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-github -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-github --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/cli-skills/pp-github .opencode/skills/pp-github && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pp-github" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-github into .opencode/skills/pp-github/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-github", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pp-github
GitHub stars: 2.1k
Token cost: ~5.7k tokens
SKILL.md length: 2,597 words
Files: 1
Skills in repo: 505
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: find duplicate issues, who owes me reviews, what changed since the last…

Works in 3 steps: Install via the Printing Press… → Verify: github-pp-cli --version → Ensure the reported install directory is…
Phrases: find duplicate issues
SKILL.md covers Prerequisites: Install the CLI, When to Use This CLI, Anti-triggers and Unique Capabilities, plus 11 more sections
Calls go, claude and npx; needs GITHUB_TOKEN and GH_TOKEN

What it does

Pp GitHub is an agent skill from mvanhorn/printing-press-library. Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: find duplicate issues, who owes me reviews, what changed since the last release, who owns this file, search github offline, use github-pp-cli, run github-pp-cli.

Its SKILL.md is about 5.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Codebase onboarding and Search implementation. It works with GitHub and SQLite. The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

Phrases: find duplicate issues
Who owes me reviews
What changed since the last release
Who owns this file

Example prompts

“/pp-github”

Requirements

Node.js
Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
Verify: github-pp-cli --version
Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

Read from SKILL.md and the folder at commit 7638ad4. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Bash
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- go
- claude
- npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- docs.github
- docs.github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- GITHUB_TOKEN
- GH_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp GitHub loads about 5.7k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 2,597 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~77
When it runs · the whole SKILL.md, loaded when a task matches: ~5.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Read, Bash
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit 7638ad4, republished under its Apache-2.0 licence (© mvanhorn). 2,597 words, ~5,713 tokens.

Download SKILL.mdSave it as .claude/skills/pp-github/SKILL.md (or your agent's skills folder).

name: pp-github
description: Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: `find duplicate issues`, `who owes me reviews`, `what changed since the last release`, `who owns this file`, `search github offline`, `use github-pp-cli`, `run github-pp-cli`.
allowed-tools: Read, Bash
author: Brandon Nye
license: Apache-2.0
argument-hint: <command> [args] | install cli|mcp

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/github/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

GitHub — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the github-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
bash
```
npx -y @mvanhorn/printing-press-library install github --cli-only
```
Verify: github-pp-cli --version
Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.4 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/github/cmd/github-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

github-pp-cli mirrors the GitHub collaboration core — issues, pull requests, commits, branches, contents, labels, releases, and search — into a local SQLite store you sync once and query offline forever. It matches the gh CLI and the official MCP server command-for-command on the scoped surfaces, then adds offline FTS search that survives GitHub's rate limits and local joins (issues to PRs to commits to authors) the online API cannot express in a single call.

When to Use This CLI

Choose github-pp-cli when you need to query GitHub's issue, PR, commit, and code-search data repeatedly or offline, when you need cross-entity answers (a symbol across issues+PRs+commits, review backlog by reviewer, file ownership) that take multiple gh calls and a spreadsheet, or when an agent needs an issue's full working set in one rate-limit-friendly read.

Anti-triggers

Do not use this CLI for:

Do not use this CLI for GitHub Actions, workflow runs, or CI status — that surface is out of scope.
Do not use this CLI for org, team, or enterprise administration.
Do not use this CLI for git operations like clone, push, or rebase — use git.
Do not use this CLI for notifications, gists, or marketplace.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Offline search and cross-entity joins

issues dupes — Find open issues whose title and body match a term, ranked by relevance, so you spot duplicates before re-triaging.

Reach for this when triaging a new issue and you need to know whether it duplicates an existing one without burning the search rate limit.
bash
```
github-pp-cli issues dupes "panic on nil map" --repo cli/cli --limit 10
```
mentions — One query across issue bodies, PR comments, and commit messages returning every place a symbol or error string appears, tagged by entity type.

Pick this over per-resource search when you need every reference to a symbol across issues, PRs, and commits at once.
bash
```
github-pp-cli mentions "ParseConfig" --repo cli/cli --since 30d --json
```
issues context — Assemble one JSON envelope for an issue: the issue, its comments, and the recent commits that mention it, ready for an agent to act on.

Use this as the first call when an agent is assigned an issue and needs its full working set in one shot instead of N round-trips.
bash
```
github-pp-cli issues context 456 --repo cli/cli --agent --select issue.title,comments.body,commits.sha
```

Release and review operations

pulls review-load — Aggregate open PRs by requested reviewer to show who has the largest unactioned review queue.

Reach for this in a pre-release sweep to find the review bottleneck before it slips the release train.
bash
```
github-pp-cli pulls review-load --repo cli/cli --state open
```
pulls stale — List open PRs with no new commit, review, or comment in N days, sorted by staleness with last-activity time.

Use this to decide which open PRs to nudge or close before they rot.
bash
```
github-pp-cli pulls stale --repo cli/cli --older-than 14d
```
repos changelog — List every commit between two refs, attach its PR when synced, and group by author for release-note prep.

Reach for this when drafting release notes and you need what merged since the last tag, organized by contributor.
bash
```
github-pp-cli repos changelog --repo cli/cli --base v2.93.0 --head v2.94.0
```

Repo intelligence

repos who-touched — For a file or directory prefix, rank committers by number of commits touching that path, with first and last touch dates.

Use this when onboarding onto an unfamiliar area to find who knows a file before you ask around.
bash
```
github-pp-cli repos who-touched internal/parser --repo cli/cli --since 90d
```
labels coverage — Report each label's open and closed issue and PR counts, and flag labels that are defined but unused and issues that are unlabeled.

Reach for this during triage hygiene to prune dead labels and catch issues that slipped through unlabeled.
bash
```
github-pp-cli labels coverage --repo cli/cli
```

Command Reference

assignees — Manage assignees

github-pp-cli assignees issues-check-user-can-be-assigned — Checks if a user has permission to be assigned to an issue in this repository.
github-pp-cli assignees issues-list — Lists the [available assignees](https://docs.github.

branches — Manage branches

github-pp-cli branches get-branch — Get a branch
github-pp-cli branches list — List branches

collaborators — Manage collaborators

github-pp-cli collaborators add — Add a user to a repository with a specified level of access.
github-pp-cli collaborators check — For organization-owned repositories, the list of collaborators includes outside collaborators
github-pp-cli collaborators list — For organization-owned repositories, the list of collaborators includes outside collaborators
github-pp-cli collaborators remove — Removes a collaborator from a repository.

comments — Manage comments

github-pp-cli comments delete-commit — Delete a commit comment
github-pp-cli comments get-commit — Gets a specified commit comment. This endpoint supports the following custom media types.
github-pp-cli comments list-commit-for-repo — Lists the commit comments for a specified repository. Comments are ordered by ascending ID.
github-pp-cli comments update-commit — Updates the contents of a specified commit comment. This endpoint supports the following custom media types.

commits — Manage commits

github-pp-cli commits get — Returns the contents of a single commit reference. You must have read access for the repository to use this endpoint.
github-pp-cli commits list — Signature verification object The response will include a verification object that describes the result of

compare — Manage compare

github-pp-cli compare <owner> <repo> <basehead> — Compares two commits against one another.

contents — Manage contents

github-pp-cli contents create-or-update-file — Creates a new file or replaces an existing file in a repository. > [!
github-pp-cli contents delete-file — Deletes a file in a repository.
github-pp-cli contents get — Gets the contents of a file or directory in a repository. Specify the file path or directory with the path parameter.

github-search — Manage github search

github-pp-cli github-search code — Searches for query terms inside of a file. This method returns up to 100 results [per page](https://docs.github.
github-pp-cli github-search commits — Find commits via various criteria on the default branch (usually main).
github-pp-cli github-search issues-and-pull-requests — Find issues by state and keyword. This method returns up to 100 results [per page](https://docs.github.
github-pp-cli github-search labels — Find labels in a repository with names or descriptions that match search keywords.
github-pp-cli github-search repos — Find repositories via various criteria. This method returns up to 100 results [per page](https://docs.github.
github-pp-cli github-search topics — Find topics via various criteria. Results are sorted by best match.
github-pp-cli github-search users — Find users via various criteria. This method returns up to 100 results [per page](https://docs.github.

issues — Interact with GitHub Issues.

github-pp-cli issues create — Any user with pull access to a repository can create an issue. If [issues are disabled in the repository](https://docs.
github-pp-cli issues delete-comment — You can use the REST API to delete comments on issues and pull requests.
github-pp-cli issues get — The API returns a [301 Moved Permanently status](https://docs.github.
github-pp-cli issues get-comment — You can use the REST API to get comments on issues and pull requests.
github-pp-cli issues get-event — Gets a single event by the event id.
github-pp-cli issues list-comments-for-repo — You can use the REST API to list comments on issues and pull requests for a repository.
github-pp-cli issues list-events-for-repo — List issue events for a repository
github-pp-cli issues list-for-repo — List issues in a repository. Only open issues will be listed. > [!
github-pp-cli issues pin-comment — You can use the REST API to pin comments on issues. This endpoint supports the following custom media types.
github-pp-cli issues reactions-create-for-comment — Create a reaction to an issue comment.
github-pp-cli issues reactions-delete-for-comment — > [!
github-pp-cli issues reactions-list-for-comment — List the reactions to an issue comment.
github-pp-cli issues unpin-comment — You can use the REST API to unpin comments on issues.
github-pp-cli issues update — Issue owners and users with push access or Triage role can edit an issue.
github-pp-cli issues update-comment — You can use the REST API to update comments on issues and pull requests.

labels — Manage labels

github-pp-cli labels issues-create — Creates a label for the specified repository with the given name and color. The name and color parameters are required.
github-pp-cli labels issues-delete — Deletes a label using the given label name.
github-pp-cli labels issues-get — Gets a label using the given name.
github-pp-cli labels issues-list-for-repo — Lists all labels for a repository.
github-pp-cli labels issues-update — Updates a label using the given label name.

languages — Manage languages

github-pp-cli languages <owner> <repo> — Lists languages for the specified repository.

milestones — Manage milestones

github-pp-cli milestones issues-create — Creates a milestone.
github-pp-cli milestones issues-delete — Deletes a milestone using the given milestone number.
github-pp-cli milestones issues-get — Gets a milestone using the given milestone number.
github-pp-cli milestones issues-list — Lists milestones for a repository.
github-pp-cli milestones issues-update — Update a milestone

pulls — Interact with GitHub Pull Requests.

github-pp-cli pulls create — Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro
github-pp-cli pulls delete-review-comment — Delete a review comment for a pull request
github-pp-cli pulls get — Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro
github-pp-cli pulls get-review-comment — Provides details for a specified review comment. This endpoint supports the following custom media types.
github-pp-cli pulls list — Lists pull requests in a specified repository.
github-pp-cli pulls list-review-comments-for-repo — Lists review comments for all pull requests in a repository. By default, review comments are in ascending order by ID.
github-pp-cli pulls reactions-create-for-request-review-comment — Create a reaction to a [pull request review comment](https://docs.github.
github-pp-cli pulls reactions-delete-for-request-comment — > [!
github-pp-cli pulls reactions-list-for-request-review-comment — List the reactions to a [pull request review comment](https://docs.github.
github-pp-cli pulls update — Draft pull requests are available in public repositories with GitHub Free and GitHub Free for organizations, GitHub Pro
github-pp-cli pulls update-review-comment — Edits the content of a specified review comment. This endpoint supports the following custom media types.

releases — Manage releases

github-pp-cli releases create — Users with push access to the repository can create a release. This endpoint triggers [notifications](https://docs.
github-pp-cli releases delete — Users with push access to the repository can delete a release.
github-pp-cli releases delete-asset — Delete a release asset
github-pp-cli releases generate-notes — Generate a name and body describing a release.
github-pp-cli releases get — Gets a public release with the specified release ID. > [!
github-pp-cli releases get-asset — To download the asset's binary content: - If within a browser
github-pp-cli releases get-by-tag — Get a published release with the specified tag.
github-pp-cli releases get-latest — View the latest published full release for the repository.
github-pp-cli releases list — This returns a list of releases, which does not include regular Git tags that have not been associated with a release.
github-pp-cli releases update — Users with push access to the repository can edit a release.
github-pp-cli releases update-asset — Users with push access to the repository can edit a release asset.

repos — Interact with GitHub Repos.

github-pp-cli repos delete — Deleting a repository requires admin access.
github-pp-cli repos get — The parent and source objects are present when the repository is a fork.
github-pp-cli repos update — Note: To edit a repository's topics, use the [Replace all repository topics](https://docs.github.

stargazers — Manage stargazers

github-pp-cli stargazers <owner> <repo> — Lists the people that have starred the repository. This endpoint supports the following custom media types.

subscribers — Manage subscribers

github-pp-cli subscribers <owner> <repo> — Lists the people watching the specified repository.

tags — Manage tags

github-pp-cli tags <owner> <repo> — List repository tags

topics — Manage topics

github-pp-cli topics get-all — Get all repository topics
github-pp-cli topics replace-all — Replace all repository topics

Show full SKILL.md (764 more words)Show less

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bash

github-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Populate the local mirror for a repository

bash

github-pp-cli sync --repo cli/cli

GitHub list endpoints are path-scoped, so sync requires --repo owner/repo. After this, offline search and the novel aggregation commands can read from the local SQLite store.

Triage duplicates before re-labeling

bash

github-pp-cli issues dupes "connection reset" --repo cli/cli --limit 10

Populates the local mirror then FTS-matches synced issue titles/bodies so you label the canonical duplicate.

Find a symbol across everything

bash

github-pp-cli mentions "ParseConfig" --repo cli/cli --since 30d --json

One local query returns every issue, PR, comment, and commit referencing the symbol, tagged by type.

Assemble an agent read-set for one issue

bash

github-pp-cli issues context 456 --repo cli/cli --agent --select issue.title,comments.body,commits.sha

Returns the issue, its comments, and mentioning commits as one narrowed JSON envelope for a single offline read.

Find who owns a file before changing it

bash

github-pp-cli repos who-touched internal/parser --repo cli/cli --since 90d

Ranks committers by commits touching the path so you know who to ask.

Auth Setup

Set a personal access token in GITHUB_TOKEN (or GH_TOKEN). A fine-grained or classic PAT with the scopes your workflow needs works; read-only scopes suffice for sync and search. github-pp-cli doctor reports your token state and remaining rate-limit budget.

Run github-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

Pipeable — JSON on stdout, errors on stderr
Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
github-pp-cli branches list mock-value mock-value --agent --select id,name,status
```
Previewable — --dry-run shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Explicit retries — use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

github-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
github-pp-cli feedback --stdin < notes.txt
github-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.local/share/github-pp-cli/feedback.jsonl. They are never POSTed unless GITHUB_FEEDBACK_ENDPOINT is set AND either --send is passed or GITHUB_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL (`application/json` or `application/x-ndjson` when `--compact`)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

github-pp-cli profile save briefing --json
github-pp-cli --profile briefing branches list mock-value mock-value
github-pp-cli profile list --json
github-pp-cli profile show briefing
github-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

Argument Parsing

Parse $ARGUMENTS:

Empty, help, or --help → show github-pp-cli --help output
Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP server:

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/github/cmd/github-pp-mcp@latest

bash

claude mcp add github-pp-mcp -- github-pp-mcp

Verify: claude mcp list

Direct Use

Check if installed: which github-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the --agent flag:

bash

github-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help: github-pp-cli <command> --help.

Files

Just SKILL.md in cli-skills/pp-github of mvanhorn/printing-press-library.

Open the folder on GitHubat commit 7638ad4

Compare with similar skills

Pp GitHub next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp GitHub compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Pp GitHub this skillmvanhorn/printing-press-library	2.1k	—	~5.7k	Automated safety check: Notes	Apache-2.0	yesterday
GitHub IssuesProrise-cool/Claude-Code-Multi-Agent	305	—	~2.2k	Automated safety check: Notes	None	21 days ago
Reference Seekteam-attention/hoyeon	173	—	~2.4k	Automated safety check: Pass	MIT	4 mo ago
GitHub MCPvibeeval/vibecosystem	531	—	~2.3k	Automated safety check: Notes	MIT	2 mo ago
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram	18k	—	~427	Automated safety check: Pass	MIT	today
Repomix Codebase Packeryamadashy/repomix	29k	—	~1.3k	Automated safety check: Notes	MIT	4 days ago

Similar skills

GitHub Issues
Prorise-cool/Claude-Code-Multi-Agent
Query and search GitHub issues using gh CLI with web fallback.
305 GitHub stars~2.2k tokensUpdated 21 days ago
Backend & APIsAuto-check: notes
Reference Seek
team-attention/hoyeon
This skill should be used when the user asks to "find references", "참고할 만한 거", "similar implementation", "오픈소스 있나", "how others do this", "레퍼런스 찾아줘", or needs to find existing patterns (internal)…
173 GitHub stars~2.4k tokensUpdated 4 mo ago
Backend & APIsAuto-check passed
GitHub MCP
vibeeval/vibecosystem
GitHub MCP Server ile GitHub API erisimi. An agent skill from vibeeval/vibecosystem.
531 GitHub stars~2.3k tokensUpdated 2 mo ago
Agent WorkflowsAuto-check: notes
GitDiagram Repository Overview
ahmedkhaleel2004/gitdiagram
Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.
18k GitHub stars~427 tokensUpdated today
DevelopmentAuto-check passed
Repomix Codebase Packer
yamadashy/repomix
Packs a local directory or remote GitHub repository into one AI-friendly file with Repomix, then searches it to explore structure, find patterns and count tokens.
29k GitHub stars~1.3k tokensUpdated 4 days ago
Agent WorkflowsAuto-check: notes
GitDiagram Repo Architecture
ahmedkhaleel2004/gitdiagram
Explains how a public GitHub repository is built by fetching its GitDiagram architecture diagram, components and optional explainer video.
18k GitHub stars~429 tokensUpdated today
DevelopmentAuto-check passed

More from mvanhorn/printing-press-library

All 505 skills in this repo

Agent Desktop
mvanhorn/printing-press-library
Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.
2.1k GitHub stars~2.3k tokensUpdated yesterday
Auto-check: notes
Gfonts
mvanhorn/printing-press-library
Search, browse, and download Google Fonts from the terminal via the gfonts CLI.
2.1k GitHub stars~574 tokensUpdated yesterday
Auto-check passed
Pp 1688
mvanhorn/printing-press-library
The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.
2.1k GitHub stars~3k tokensUpdated yesterday
Auto-check: notes
Pp Activity Japan
mvanhorn/printing-press-library
Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.
2.1k GitHub stars~2k tokensUpdated yesterday
Auto-check: notes
Pp Adminbyrequest
mvanhorn/printing-press-library
Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...
2.1k GitHub stars~3.3k tokensUpdated yesterday
Auto-check: notes
Pp Agent Capture
mvanhorn/printing-press-library
macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.
2.1k GitHub stars~1.6k tokensUpdated yesterday
Auto-check: notes

Works with

Questions about Pp GitHub

What does Pp GitHub do?

Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: find duplicate issues, who owes me reviews, what changed since the last…. Pp GitHub is an agent skill from mvanhorn/printing-press-library. Every gh issue, PR, repo, and code-search workflow, plus a local SQLite mirror, offline full-text search Trigger phrases: find duplicate issues, who owes me reviews, what changed since the last release, who owns this file, search github offline, use github-pp-cli, run github-pp-cli.

When should I use Pp GitHub?

Pp GitHub fits situations like: phrases: find duplicate issues; who owes me reviews; what changed since the last release; who owns this file.

How do I install Pp GitHub in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-github -a claude-code`. Or copy the skill folder (cli-skills/pp-github in mvanhorn/printing-press-library) into .claude/skills/pp-github in your project. Claude Code loads it when a task matches its description.

How do I install Pp GitHub in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-github -a codex`. Or copy the skill folder (cli-skills/pp-github in mvanhorn/printing-press-library) into .agents/skills/pp-github in your project. Codex loads it when a task matches its description.

Can I use Pp GitHub in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-github -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-github, .gemini/skills/pp-github, .github/skills/pp-github and .opencode/skills/pp-github in your project.

What does Pp GitHub need to run?

Going by SKILL.md and its folder, Pp GitHub needs the command-line tools its instructions call (go, claude and npx) and credentials named GITHUB_TOKEN and GH_TOKEN. Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp GitHub access the network?

SKILL.md names 2 domains. As links in the text: docs.github and docs.github.com. This is read from the text; nothing was executed.

Is Pp GitHub safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp GitHub use?

Pp GitHub is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp GitHub use?

About 5.7k tokens (SKILL.md is roughly 23k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp GitHub?

Skills that share tags, products or a category with Pp GitHub: GitHub Issues (Prorise-cool/Claude-Code-Multi-Agent, 305 stars), Reference Seek (team-attention/hoyeon, 173 stars), GitHub MCP (vibeeval/vibecosystem, 531 stars) and GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp GitHub?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,053 GitHub stars. The repository holds 505 skills in this directory. The repository was last updated on October 6, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Pp GitHub

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

GitHub — Printing Press CLI

Prerequisites: Install the CLI

When to Use This CLI

Anti-triggers

Unique Capabilities

Offline search and cross-entity joins

Release and review operations

Repo intelligence

Command Reference

Finding the right command

Recipes

Populate the local mirror for a repository

Triage duplicates before re-labeling

Find a symbol across everything

Assemble an agent read-set for one issue

Find who owns a file before changing it

Auth Setup

Agent Mode

Response envelope

Agent Feedback

Output Delivery

Named Profiles

Exit Codes

Argument Parsing

MCP Server Installation

Direct Use

Files

Compare with similar skills

Similar skills

More from mvanhorn/printing-press-library

Related

Questions about Pp GitHub