skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
daisuke897/dotfiles50 installs

forgejo-cli-ops

Use the Forgejo CLI (fj) to authenticate and operate on a Forgejo instance (issues, PRs, repositories) with correct host handling.

How do I install this agent skill?

npx skills add https://github.com/daisuke897/dotfiles --skill forgejo-cli-ops
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides documentation and command-line examples for using the Forgejo CLI (fj). It correctly guides the user to use secure credential storage mechanisms like secret-tool and uses placeholders for all sensitive values. No malicious patterns or security risks were identified.

  • Socketpass

    No alerts

  • Snykfail

    Risk: HIGH · 2 issues

  • Runlayerwarn

    1/1 file flagged

What does this agent skill do?

Scope

  • Authenticate to a Forgejo host and verify access.
  • Run common issue/PR/repo commands with the correct host.
  • Troubleshoot host and login mismatches.

Prerequisites

  • A Forgejo Personal Access Token (PAT) created in the Forgejo web UI.
  • fj installed and available in PATH.
  • Optional: secret-tool (GNOME Keyring) for secure token storage.

Host usage (important)

-H/--host is a global option and must be placed before subcommands.

fj -H <FORGEJO_HOST> repo view <owner>/<repo>

To avoid repeating the host, set FJ_HOST:

export FJ_HOST=<FORGEJO_HOST>

Authentication (secret-tool example)

Store your token (one-time) and register with fj:

echo -n "<PAT_VALUE>" | secret-tool store --label="Forgejo PAT" service forgejo user <username>@<FORGEJO_HOST>
echo -n "$(secret-tool lookup service forgejo user <username>@<FORGEJO_HOST>)" | fj -H <FORGEJO_HOST> auth add-key <username>

Verify:

fj -H <FORGEJO_HOST> auth list
fj -H <FORGEJO_HOST> whoami

Cleanup

fj auth logout <FORGEJO_HOST>
secret-tool clear service forgejo user <username>@<FORGEJO_HOST>

Troubleshooting

  • Error: not logged in often means the host defaulted to github.com; add -H or set FJ_HOST.
  • If secret-tool lookup returns nothing, unlock your keyring or confirm the stored user/host key.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/daisuke897/dotfiles/forgejo-cli-ops">View forgejo-cli-ops on skillZs</a>