rootiest-ai/dist/agy/rootiest-ai-all/skills/mirror-it/SKILL.md

name, description, version, user-invocable, author

name	description	version	user-invocable	author
mirror-it	Configures a Gitea repository to automatically push-mirror its contents to GitHub using the `tea` CLI and `jq`.	1.0.0	true	Rootiest

Gitea to GitHub Push Mirror

Objective

Register a Gitea push mirror so a repository's commits are automatically forwarded to a corresponding GitHub repository, via tea api against Gitea's push_mirrors endpoint.

Trigger Conditions

Activate this skill ONLY when one of the following is met:

1. The user explicitly types the command /mirror-it.
2. The user makes a natural-language request to mirror the repository (e.g., "Mirror this repository to GitHub", "Mirror this example-config repo...").
3. You confidently infer the user intends to mirror the current repository, AND have verified that a GitHub repository does not already exist at the target address.

Constraints & Relevance

• Gitea only: this skill is relevant ONLY for repositories hosted on a Gitea instance (e.g., git.rootiest.dev). Do NOT trigger it for repositories natively hosted on GitHub — GitHub does not support push-mirroring to itself.
• Security: never read, print, or otherwise expose the value of $GITHUB_TOKEN (whether it comes from the environment or a .env file — see Prerequisites). Pass the variable reference directly into shell commands so it is only ever expanded by the shell, never written out by you.
• Shell environment: the snippet below is POSIX-compatible (var=$(command)), since the command executes through whatever shell the tool invokes it with (bash/zsh/sh) — never assume Fish syntax is available. An exported variable (set -gx in Fish, export in bash/zsh) is inherited by every child process regardless of which shell that child happens to run, so variables from the user's interactive shell config are already present without any special handling.

Prerequisites

• tea is installed and already authenticated against the target Gitea instance (tea login list).
• jq is installed.
• $GITHUB_USER and $GITHUB_TOKEN (a GitHub PAT with repo scope) are available before step 3 below — either already exported in the environment, or defined in a .env file at the repository root (see step 1).

Defaults & Overrides

Unless the user says otherwise, assume:

• Target name ($TARGET_REPO): the exact name of the current Gitea repository.
• Interval ($INTERVAL): "8h".
• Sync on commit ($SYNC_ON_COMMIT): true.

Example override: "Mirror this example-config repo, but don't sync on commit and use the name 'exmpl_cfg'" → $TARGET_REPO becomes exmpl_cfg, $SYNC_ON_COMMIT becomes false.

Execution Steps

1. If $GITHUB_USER or $GITHUB_TOKEN is not already set, and a .env file exists at the repository root, load it before doing anything else — without ever printing or cat-ing its contents:

   set -a; . ./.env; set +a
   

   Variables already present in the environment take priority: only fall back to .env for whichever of the two is still unset. If neither source provides both, stop and tell the user what's missing.
2. Identify the current Gitea repository's owner ($OWNER) and name ($SOURCE_REPO).
3. Determine $TARGET_REPO, $INTERVAL, and $SYNC_ON_COMMIT from the defaults above, applying any user overrides.
4. Run the following snippet, substituting those values. Credentials are passed as separate remote_username/remote_password fields — never embedded in the mirror URL — per Gitea's CreatePushMirrorOption schema.

# $OWNER / $SOURCE_REPO identify the local Gitea API endpoint.
# $TARGET_REPO is the destination repository name on GitHub.
# $INTERVAL and $SYNC_ON_COMMIT come from the Defaults & Overrides step above.

payload=$(jq -n \
  --arg addr "https://github.com/$GITHUB_USER/$TARGET_REPO.git" \
  --arg user "$GITHUB_USER" \
  --arg pass "$GITHUB_TOKEN" \
  --arg interval "$INTERVAL" \
  --argjson sync $SYNC_ON_COMMIT \
  '{remote_address: $addr, remote_username: $user, remote_password: $pass, interval: $interval, sync_on_commit: $sync}'
)

tea api --method POST --data "$payload" "repos/$OWNER/$SOURCE_REPO/push_mirrors"

5. Report the outcome to the user, without echoing the request body, .env contents, or token.