A comprehensive automation suite for managing Forgejo instances via CLI and REST API, covering everything from issue tracking to CI/CD monitoring.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install forgejo-fj-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install forgejo-fj-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Forgejo Workflow?
The Forgejo Workflow is a specialized addition to the library of Openclaw Skills designed to provide seamless interaction with Forgejo instances. By integrating the fj CLI and the Forgejo REST API, this skill enables AI agents to perform complex repository operations, manage collaborative workflows, and maintain project documentation without leaving the terminal environment. It bridges the gap between local development and remote repository management, offering a robust set of tools for modern devops practices.
This skill is particularly valuable for teams seeking to automate their Forgejo-hosted projects. It handles the nuances of authentication, repository resolution, and API pagination, ensuring that developers can focus on code while the agent manages the administrative overhead of issues, pull requests, and releases. Whether you are performing a structured code review or migrating a repository, this skill provides the necessary technical depth to interact with Forgejo efficiently.
Forgejo Workflow Use Cases
- Automating the creation, labeling, and management of repository issues.
- Streamlining pull request lifecycles, including creation, local checkout for testing, and merging.
- Managing repository migrations, forks, and releases across different Forgejo instances.
- Reading and updating project wikis programmatically.
- Monitoring Forgejo Actions and CI status to ensure build stability.
How Forgejo Workflow Works
- The skill performs a readiness check by verifying the availability of fj, curl, jq, and git binaries.
- It validates the presence of essential environment variables such as FORGEJO_URL and FORGEJO_TOKEN for authentication.
- Repository context is resolved based on local git remotes or explicit user configuration.
- Standard operations are executed via the fj CLI for high-level efficiency.
- Advanced or unsupported operations fall back to raw REST API calls using curl and jq for maximum flexibility.
- For code reviews, the skill coordinates local git states with remote PR metadata to facilitate deep analysis.
Forgejo Workflow Setup
To get started with this entry in the Openclaw Skills collection, first install the Forgejo CLI:
brew install forgejo-cli
Next, configure your environment variables with your instance details and personal access token:
export FORGEJO_URL="https://your-forgejo-host"
export FORGEJO_TOKEN="your_forgejo_pat"
Finally, authenticate the fj CLI tool for your target host:
fj auth add-key <username>
Forgejo Workflow Data Schema & Taxonomy
The skill manages data across several Forgejo entities, using both CLI outputs and JSON responses from the REST API.
| Entity | Data Managed | Source |
|---|---|---|
| Repositories | Metadata, visibility, forks, and migration settings | fj repo / API |
| Issues | Titles, bodies, labels, and milestones | fj issue / API |
| Pull Requests | Branch refs, review comments, and merge status | fj pr / Git |
| Wiki | Page content and navigation | fj wiki / API |
| CI/Actions | Task status, logs, and run IDs | fj actions / API |
Forgejo Workflow Advanced Features
- Multi-host support allowing explicit target instance selection via CLI flags.
- AGIT workflow integration for specialized local-git push-to-PR capabilities.
- Automated merge-base computation for precise code review diffs.
- Sophisticated migration support that includes wikis, releases, and issues via non-git migration services.
- Intelligent pagination handling for large datasets retrieved through the Forgejo API.
SKILL.md
Loading
Related Openclaw Skills
AI SBTI Skill Test SEO Operations
An AI-powered SEO suite for SBTI platforms that automates backlink prioritization and internal link-juice distribution.
SYSU Anything CLI
A comprehensive command-line interface for Sun Yat-sen University students to manage academic schedules, campus bookings, and shuttle services.
Manual QA Checklist Generator
A smart utility that analyzes code changes to generate comprehensive, split-responsibility QA checklists for automated and manual verification.
OpenClaw Session Cleanup
A maintenance utility designed to optimize OpenClaw by purging accumulated subagent and cron job session data from sessions.json.
Automated QA Testing Bots
A comprehensive automation skill that enables AI agents to build, run, and manage end-to-end QA testing suites using Puppeteer and Playwright.
Doubao SeeDream Image Generator
A high-performance AI image generation skill leveraging ByteDance's Doubao SeeDream 5.0 model for professional-grade visual creation via CLI or agent commands.
Featured*
