Agent skill · software engineering · mvanhorn
pp-forgejo
The `gh` for Forgejo — works with any instance, stores your data locally, and speaks Forgejo natively. Trigger phrases: `check my forgejo issues`, `list pull requests on forgejo`, `create a release on codeberg`, `runner status across orgs`, `upload release assets to forgejo`, `use fj`, `use forgejo-pp-cli`.
Why this skill is useful
Adds executable scripts for managing Forgejo instances that are not available in public documentation.
What it needs
Requires forgejo-pp-cli installed locally. About 11k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
Forgejo — Printing Press CLI Prerequisites: Install the CLI This skill drives the forgejo-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer: 2. Verify: forgejo-pp-cli --version 3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer): If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds. fj brings GitHub CLI-level ergonomics to every Forgejo instance: multi-host auth with OAuth2 device flow, offline-searchable local SQLite, cross-repo dashboards, and Forgejo-specific features (runner management, ActivityPub, repo migration) that no other tool exposes. Works with Codeberg, self-hosted instances, and Forgejo Cloud with the same command surface. When to Use This CLI Use fj when working with any Forgejo or Codeberg instance from the command line: triage issues across multiple repos, manage PRs and releases, monitor CI and runners, or script release pipelines. Especially suited for teams running self-hosted Forgejo who want gh-equivalent ergonomics without being on GitHub. Unique Capabilities These capabilities aren't available in any other tool for this API. Local state that compounds issue dashboard — See all your open issues across every repo (and every Forgejo host) in one sorted table — no browser, no tab-switching. Use this when you need a triage-ready list of issues spanning multiple repos or instances without opening a browser. notification inbox — One inbox for all your Forgejo instances — Codeberg, company Forgejo, university instance — sorted by recency with a host column. Use when a contributor works across multiple Forgejo instances and needs to triage notifications without switching browser profiles. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/forgejo