silverbullet-icalendar/gitea-push-watch/SKILL.md

name, description

name	description
gitea-push-watch	Monitor and debug Gitea Actions after a push. Use when a user asks to check if an action ran or failed on a Gitea instance, and use the provided API token for authentication.

Gitea Push Watch

This skill provides tools to monitor Gitea Actions and debug failures using the Gitea API.

Workflow

1. Identify Repository Info: Extract the Gitea server URL and repository path (e.g., owner/repo) from the project context or git remote.
2. Authenticate: Use the user-provided API token. Ensure it is passed as a token <value> header in API calls.
3. Monitor Run: Use the scripts/gitea_action_monitor.py script to check the status of the latest run.
4. Analyze Failures: If a run fails, use the Gitea API to fetch specific job logs to identify the root cause (e.g., permission issues, network errors).

Script Usage

python3 scripts/gitea_action_monitor.py <server_url> <repo_path> <api_token>

Example:

python3 scripts/gitea_action_monitor.py https://gitea.example.com sstent/my-repo MY_TOKEN

Common Gitea API Endpoints

• List runs: GET /api/v1/repos/{owner}/{repo}/actions/runs
• Get run details: GET /api/v1/repos/{owner}/{repo}/actions/runs/{id}
• List jobs: GET /api/v1/repos/{owner}/{repo}/actions/runs/{id}/jobs