The Codeberg skill gives an AI agent full programmatic access to Codeberg.org and any self-hosted Gitea or Forgejo instance through the Gitea REST API v1. It is designed for agents that need to do more than generate text — they can create and update repository files, manage branches, push multiple files in a single atomic commit using the Git Trees API workflow, fetch and apply object SHAs to avoid conflicts, create releases, manage tags, and upload binary release assets.
Authentication works in two modes. In single-account mode the agent uses a Personal Access Token configured directly in the skill. In multi-account mode, a locally run Tunnel-Proxy routes requests between accounts, keeping each token on the local machine and out of the skill configuration file. The skill detects which mode is active and adjusts routing accordingly.
Required token scopes are repository and user; issue, notification, misc, and activitypub scopes are optional depending on which operations are needed. Organization and package scopes are not used.
The skill targets Claude specifically — domain allowlisting in Claude settings is required before outbound requests to codeberg.org (and an ngrok domain if using the proxy) will succeed. It is not a generic MCP server and does not connect to GitHub, GitLab, or other Git hosting platforms. Developers already working in the Forgejo/Gitea ecosystem who want agent-driven repository automation are the primary audience.