codeberg

Bridge the gap between your AI and Codeberg

Seamlessly integrate your development workflow with Codeberg. This skill enables AI agents to interact directly with Codeberg repositories using the Gitea REST API v1, providing a robust alternative to GitHub-centric tools.

What it does

This skill transforms your agent into a fully capable Git collaborator. It handles the complexities of the Gitea API, allowing your agent to:

• Manage Files: Read, create, and update files with automatic Base64 encoding/decoding and SHA management.
• Repository Intelligence: Search and list repositories, browse directory structures, and inspect branch details.
• Advanced Versioning: Create and manage releases, track tags, and upload binary release assets.
• Batch Operations: Execute multi-file commits using the Git Trees API for complex code changes.

Why use this skill

Manual prompting for API interactions is prone to errors like SHA mismatches or incorrect endpoint paths. This skill provides a structured, fail-safe environment with built-in request routing. It features a dual-path architecture that prioritizes secure proxy connections while maintaining a direct API fallback, ensuring your agent remains operational even if one connection path is interrupted.

Proxy setup (recommended)

This skill supports an optional local proxy that keeps your API tokens off Claude entirely — they stay on your machine and are never stored in the skill file. The proxy runs locally and is tunnelled via ngrok so Claude can reach it from anywhere.

→ claude-local-proxy — full setup instructions for Windows, macOS, Linux, and Termux, including autostart.

If you prefer not to run a proxy, fill in the TOKEN field in the skill config directly and leave the proxy fields as placeholders. The skill will detect this and skip the proxy ping automatically.

Allow your proxy domain in Claude settings

For Claude to reach your proxy, your ngrok domain must be whitelisted:

1. Open Claude → Settings → Capabilities
2. Ensure Cloud code execution and file creation is enabled
3. Under Domain allowlist, add your ngrok domain — e.g. your-domain.ngrok-free.dev
4. Click Add

Without this step, Claude's sandbox will block outbound requests to your proxy.

Supported Tools & Frameworks

• Platform: Codeberg.org (Gitea-based)
• API: Gitea REST API v1
• Auth: Supports both Proxy Secret and Personal Access Token (PAT) authentication
• Data: Full JSON support with Base64 content handling