Skip to content

moeru-ai/upload-github-attachment-skill

upload-github-attachment

Verified

Upload a local image or file to GitHub's user-attachments storage and return a URL suitable for issue, pull request, discussion, or comment Markdown. Use when Codex must embed local screenshots, videos, logs, or other evidence in GitHub content without committing the files to a repository.

FileKindSize
SKILL.mdskill md2.2 KB
agents/openai.yamlconfig223 B
scripts/upload-github-attachment.shexecutablescript2.7 KB

scripts/upload-github-attachment.sh

View on GitHub
#!/usr/bin/env bash

set -euo pipefail

usage() {
  printf 'Usage: %s [--repo OWNER/REPO] [--content-type MIME] FILE\n' "$(basename "$0")"
}

repository=''
content_type=''

while (($# > 0)); do
  case "$1" in
    --repo)
      repository="${2:-}"
      shift 2
      ;;
    --content-type)
      content_type="${2:-}"
      shift 2
      ;;
    --help|-h)
      usage
      exit 0
      ;;
    --*)
      printf 'Unknown option: %s\n' "$1" >&2
      usage >&2
      exit 2
      ;;
    *)
      if [[ -n "${attachment_file:-}" ]]; then
        printf 'Only one file can be uploaded per invocation.\n' >&2
        exit 2
      fi
      attachment_file="$1"
      shift
      ;;
  esac
done

if ! command -v gh >/dev/null 2>&1; then
  printf 'GitHub CLI (gh) is required. Install it, then run gh auth login or set GH_TOKEN/GITHUB_TOKEN.\n' >&2
  exit 127
fi

if ! command -v curl >/dev/null 2>&1; then
  printf 'curl is required.\n' >&2
  exit 127
fi

if [[ -z "${attachment_file:-}" || ! -f "$attachment_file" ]]; then
  printf 'Provide one existing local file.\n' >&2
  usage >&2
  exit 2
fi

if [[ -z "$repository" ]]; then
  repository="$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)"
fi

if [[ -z "$repository" ]]; then
  printf 'Could not resolve a GitHub repository. Run inside a checkout or pass --repo OWNER/REPO.\n' >&2
  exit 2
fi

attachment_token="${GH_TOKEN:-${GITHUB_TOKEN:-}}"
if [[ -z "$attachment_token" ]]; then
  attachment_token="$(gh auth token 2>/dev/null || true)"
fi

if [[ -z "$attachment_token" ]]; then
  printf 'GitHub authentication is required. Run gh auth login or set GH_TOKEN/GITHUB_TOKEN.\n' >&2
  exit 1
fi

if [[ -z "$content_type" ]]; then
  if ! command -v file >/dev/null 2>&1; then
    printf 'The file utility is required for MIME detection; install it or pass --content-type.\n' >&2
    exit 127
  fi
  content_type="$(file --brief --mime-type "$attachment_file")"
fi

repository_id="$(GH_TOKEN="$attachment_token" gh api "repos/$repository" --jq .id)"
attachment_name="$(basename "$attachment_file")"

response="$(curl --silent --show-error --fail-with-body \
  --request POST \
  --header "Authorization: Bearer $attachment_token" \
  --header 'Accept: application/json' \
  --url-query "name=$attachment_name" \
  --url-query "content_type=$content_type" \
  --url-query "repository_id=$repository_id" \
  --data-binary "@$attachment_file" \
  'https://uploads.github.com/user-attachments/assets')"

attachment_url="$(printf '%s' "$response" | sed -n 's/.*"url"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p')"

if [[ "$attachment_url" != https://github.com/user-attachments/* ]]; then
  printf 'GitHub did not return a user-attachment URL.\n' >&2
  exit 1
fi

printf '%s\n' "$attachment_url"
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall