gitea/SKILL.md

name, description

name	description
gitea	Interact with Gitea repositories, issues, PRs, CI runs, and files via git.dominat.us. Use when working with Gitea repos, triaging issues, reviewing PRs, checking CI logs, creating branches, updating files, managing webhooks, or configuring bot response behavior.

Gitea

Tools for interacting with a Gitea instance (git.dominat.us by default).

When to Use

• Listing, viewing, or searching repositories
• Reading or triaging issues
• Reviewing or creating pull requests
• Checking CI workflow runs and logs
• Reading or updating files in a repo via the API
• Creating branches for feature work
• Setting up webhooks for event notifications
• Configuring which repos the bot monitors and how it responds

Quick Reference

See TOOL.md for full parameter details on every tool.

Read Operations

Tool	Purpose
gitea_list_repos	List repos (yours or another owner's)
gitea_list_issues	List issues on a repo
gitea_get_issue	Get issue details + comments
gitea_list_prs	List pull requests
gitea_get_pr	Get PR details + comments
gitea_list_runs	List CI workflow runs
gitea_get_run_logs	Get full CI logs for a run
gitea_get_file_content	Read a file from a repo

Write Operations

Tool	Purpose
gitea_create_repo	Create a new repository
gitea_ensure_repo	Get or create a repository
gitea_create_issue	Open a new issue
gitea_create_issue_comment	Comment on an issue or PR
gitea_edit_issue	Change title, body, or state of an issue
gitea_create_branch	Create a branch
gitea_update_file	Create or update a file (handles new vs existing automatically)
gitea_create_pr	Open a pull request
gitea_merge_pr	Merge a pull request
gitea_create_webhook	Add a webhook to a repo

Management

Tool	Purpose
gitea_repo_config	Set per-repo response mode ("all" or "mention")
gitea_tracked_repos	List all tracked repos with type and response mode

Common Workflows

Triage an Issue

1. gitea_list_issues to see open issues
2. gitea_get_issue to read details and comments
3. gitea_create_issue_comment to respond
4. gitea_edit_issue with state: "closed" when resolved

Fix an Issue via PR

1. gitea_get_issue to understand the problem
2. gitea_create_branch to create a feature branch
3. gitea_get_file_content to read the file(s) that need fixing (saves the SHA)
4. gitea_update_file to push the fix on the feature branch (pass the SHA for existing files)
5. gitea_create_pr to open a PR referencing the issue
6. gitea_edit_issue with state: "closed" to close the issue

Check CI Status

1. gitea_list_runs to see recent workflow runs
2. gitea_get_run_logs to read logs for a failing run

Configure Bot Behavior

• gitea_tracked_repos — see what the bot is monitoring
• gitea_repo_config repo="owner/name" respondTo="all" — respond to all events on this repo
• gitea_repo_config repo="owner/name" respondTo="mention" — only respond when @mentioned

Configuration

Variable	Purpose	Default
GITEA_URL	Gitea instance URL	https://git.dominat.us
GITEA_TOKEN	API token (required)	—
GITEA_USER	Bot's own username	—
GITEA_OWNER	Default repo owner	—
GITEA_REPO	Default repo name	—

Most tools accept owner and repo parameters to override defaults per-call.

See TOOL.md for the full environment variable reference including webhook server and openclaw hooks settings.