# Push to GitHub

> Initialize /work as a git repo, create the GitHub repo, push, return the URL.

- **Kind**: Shell tool
- **Category**: engineering
- **Owner**: Sentinel (/sentinel)
- **Default model**: sonnet
- **Cost class**: cheap (Haiku-class model. Cents per invocation.)
- **Turn budget**: 5
- **Execution**: synchronous (result lands in the same turn)
- **Canonical URL**: https://app.51ultron.com/docs/skills/push-to-github

## What it does

Wraps ultron-github-push: inits /work as a git repo if needed, commits the current state, creates the GitHub repo under the user's account using GH_TOKEN, pushes the initial commit, returns the repo URL. Optionally opens a draft PR if --pr is requested.

## When to use this

- user wants to push /work to a new GitHub repo
- user says 'put this on GitHub' / 'create a repo for this' / 'open-source this'
- user wants the code shareable / under version control externally

## When NOT to use this

- user already has a remote and just wants to commit + push → use shell_exec with git directly
- user wants to fork an existing repo → use shell_exec with gh CLI directly

## Example prompts

- `push this to GitHub as a new repo named cool-app`
- `create a GitHub repo for this and push it`
- `open-source this with the name foo-bar`

## Inputs

- **repo_name**: kebab-case GitHub repo name
- **private**: true|false (default false)

## Output

GitHub repo URL.

## Tools used

`shell_exec`

## Integrations required

`github`

## Execution template

Shell tools dispatch through `shell_exec` with the following command template:

```bash
ultron-github-push {{repo_name}}
```

## Tags

`engineering`, `github`, `ship`

## Keywords

github, push, create repo, open source, ultron-github-push, gh