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-opsIs 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.
fjinstalled 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 inoften means the host defaulted to github.com; add-Hor setFJ_HOST.- If
secret-tool lookupreturns nothing, unlock your keyring or confirm the stored user/host key.
How can the creator link this skill?
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>