Forgejo Skills

Reusable skills for Forgejo-focused agents.

Current skill:

• forgejo-api: local Swagger mirror, task router, workflow playbooks, and query scripts for the Forgejo REST API

Install

For Codex and other supported agents:

npx skills add nichtlegacy/forgejo-skill

Install just this skill from a multi-skill repo:

npx skills add nichtlegacy/forgejo-skill --skill forgejo-api

Local discovery check:

npx skills add ./ --list

What This Repo Contains

skills/
  forgejo-api/
    SKILL.md
    agents/openai.yaml
    references/
    scripts/
skills.sh.json
README.md

The actual installable skill package lives under skills/forgejo-api/. Root files are only for repository-level publishing and skills.sh presentation.

Publish Notes

• skills.sh.json customizes the repository page on skills.sh
• after the repo is published and installed at least once through the CLI, skills.sh can pick it up for indexing
• the install command for Codex follows the current skills.sh guidance: npx skills add nichtlegacy/forgejo-skill

Repository links:

GitHub:   https://github.com/nichtlegacy/forgejo-skill
skills.sh: https://www.skills.sh/nichtlegacy/forgejo-skill

Local Maintenance

Refresh the Forgejo snapshot and generated references:

python3 skills/forgejo-api/scripts/refresh_forgejo_api_docs.py

Validate the packaged skill:

python3 skills/forgejo-api/scripts/validate_skill.py