From dd9c1c00901b0b3bd840d43e30013ab0bc0b520a Mon Sep 17 00:00:00 2001 From: Hugo Nijhuis Date: Mon, 12 Jan 2026 12:32:13 +0100 Subject: [PATCH] refactor(skills): apply progressive disclosure to gitea skill Split gitea skill into main file and reference documentation. Main SKILL.md now focuses on core commands (154 lines, down from 201), with setup/auth and CI/Actions moved to reference files. Co-Authored-By: Claude Code --- skills/gitea/SKILL.md | 79 ++++++---------------------- skills/gitea/reference/actions-ci.md | 45 ++++++++++++++++ skills/gitea/reference/setup.md | 49 +++++++++++++++++ 3 files changed, 110 insertions(+), 63 deletions(-) create mode 100644 skills/gitea/reference/actions-ci.md create mode 100644 skills/gitea/reference/setup.md diff --git a/skills/gitea/SKILL.md b/skills/gitea/SKILL.md index 1cc3fe9..6970bf3 100644 --- a/skills/gitea/SKILL.md +++ b/skills/gitea/SKILL.md @@ -7,46 +7,15 @@ user-invocable: false # Gitea CLI (tea) -Command-line interface for interacting with Gitea repositories. +Command-line interface for Gitea repositories. Use `tea` for issue/PR management in Gitea instances. -## Installation - -```bash -brew install tea -``` - -## Authentication - -The `tea` CLI authenticates via `tea logins add`. Credentials are stored locally by tea. - -```bash -tea logins add # Interactive login -tea logins add --url --token --name # Non-interactive -tea logins list # Show configured logins -tea logins default # Set default login -``` - -## Configuration - -Config is stored at `~/Library/Application Support/tea/config.yml` (macOS). - -To avoid needing `--login` on every command, set defaults: - -```yaml -preferences: - editor: false - flag_defaults: - remote: origin - login: git.flowmade.one -``` +**Setup required?** See [reference/setup.md](reference/setup.md) for installation and authentication. ## Repository Detection `tea` automatically detects the repository from git remotes when run inside a git repository. Use `--remote ` to specify which remote to use. -## Common Commands - -### Issues +## Issues ```bash # List issues @@ -81,7 +50,7 @@ tea issues deps add 5 owner/repo#3 # Cross-repo dependency tea issues deps remove # Remove a dependency ``` -### Pull Requests +## Pull Requests ```bash # List PRs @@ -121,15 +90,7 @@ tea pulls merge --style rebase-merge # Rebase then merge tea pulls clean # Delete local & remote branch ``` -### Repository - -```bash -tea repos # List repos -tea repos / # Repository info -tea clone / # Clone repository -``` - -### Comments +## Comments ```bash # Add comment to issue or PR @@ -145,7 +106,15 @@ tea comment 3 "## Review Summary > **Warning**: Do not use heredoc syntax `$(cat <<'EOF'...EOF)` with `tea comment` - it causes the command to be backgrounded and fail silently. -### Notifications +## Repository + +```bash +tea repos # List repos +tea repos / # Repository info +tea clone / # Clone repository +``` + +## Notifications ```bash tea notifications # List notifications @@ -179,22 +148,6 @@ tea issues -r owner/repo # Specify repo directly - Use `--remote gitea` when you have multiple remotes (e.g., origin + gitea) - The `tea pulls checkout` command is handy for reviewing PRs locally -## Actions / CI +## Advanced Topics -```bash -# List workflow runs -tea actions runs # List all workflow runs -tea actions runs -o json # JSON output for parsing - -# List jobs for a run -tea actions jobs # Show jobs for a specific run -tea actions jobs -o json # JSON output - -# Get job logs -tea actions logs # Display logs for a job - -# Full workflow: find failed job logs -tea actions runs # Find the run ID -tea actions jobs # Find the job ID -tea actions logs # View the logs -``` +- **CI/Actions debugging**: See [reference/actions-ci.md](reference/actions-ci.md) diff --git a/skills/gitea/reference/actions-ci.md b/skills/gitea/reference/actions-ci.md new file mode 100644 index 0000000..ab4970f --- /dev/null +++ b/skills/gitea/reference/actions-ci.md @@ -0,0 +1,45 @@ +# Gitea Actions / CI + +Commands for debugging CI/Actions workflow failures in Gitea. + +## Workflow Runs + +```bash +# List workflow runs +tea actions runs # List all workflow runs +tea actions runs -o json # JSON output for parsing +``` + +## Jobs + +```bash +# List jobs for a run +tea actions jobs # Show jobs for a specific run +tea actions jobs -o json # JSON output +``` + +## Logs + +```bash +# Get job logs +tea actions logs # Display logs for a job +``` + +## Full Workflow: Find Failed Job Logs + +```bash +# 1. Find the run ID +tea actions runs + +# 2. Find the job ID from that run +tea actions jobs + +# 3. View the logs +tea actions logs +``` + +## Tips + +- Use `-o json` with runs/jobs for programmatic parsing +- Run IDs and Job IDs are shown in the output of the respective commands +- Logs are displayed directly to stdout (can pipe to `grep` or save to file) diff --git a/skills/gitea/reference/setup.md b/skills/gitea/reference/setup.md new file mode 100644 index 0000000..4d55a63 --- /dev/null +++ b/skills/gitea/reference/setup.md @@ -0,0 +1,49 @@ +# Gitea CLI Setup + +One-time installation and authentication setup for `tea` CLI. + +## Installation + +```bash +brew install tea +``` + +## Authentication + +The `tea` CLI authenticates via `tea logins add`. Credentials are stored locally by tea. + +```bash +tea logins add # Interactive login +tea logins add --url --token --name # Non-interactive +tea logins list # Show configured logins +tea logins default # Set default login +``` + +## Configuration + +Config is stored at `~/Library/Application Support/tea/config.yml` (macOS). + +To avoid needing `--login` on every command, set defaults: + +```yaml +preferences: + editor: false + flag_defaults: + remote: origin + login: git.flowmade.one +``` + +## Example: Flowmade One Setup + +```bash +# Install +brew install tea + +# Add login (get token from https://git.flowmade.one/user/settings/applications) +tea logins add --name flowmade --url https://git.flowmade.one --token + +# Set as default +tea logins default flowmade +``` + +Now `tea` commands will automatically use the flowmade login when run in a repository with a git.flowmade.one remote.