submit

name: submit description: "Top-level orchestrator: branch (if needed), commit, push, then open a PR. Each step asks for confirmation before continuing, unless --non-interactive is passed." argument-hint: "[--non-interactive] [--no-log] [issue reference or topic hint, e.g. 'Fixes #2143']" user-invocable: true

/inki:submit: branch + commit + push + PR

Step 0: Parse arguments

If $ARGUMENTS contains --help or -h, print usage and stop, per ../../references/help.md. Do not run the workflow.

Otherwise, from $ARGUMENTS, detect the autonomy flag anywhere in the list: --non-interactive (canonical), aliases --auto-approve, --auto, --yes, -y, --no-questions-asked (all equivalent). If present, set AUTO=true and remove the flag. What remains is the optional issue reference passed through to /inki:pr.

Logging: unless --no-log is passed, write this skill's report to the run log per ../../references/logging.md (--log-dir <path> and --short-log are also accepted). When invoked as part of an orchestrator (e.g. /inki:document), write into that run's existing directory instead of creating a new one.

Workflow

Each step below is performed by invoking the named sub-skill, never by running the equivalent git / gh commands directly. The sub-skills carry behavior that is not visible from git-rules.md alone (for example, /inki:pr appends the Vercel preview link as the last line of the PR body). Re-implementing a step by hand silently drops that behavior. This is a hard rule, see the Rules section.

Branch: if currently on main, invoke /inki:branch to create a properly prefixed branch.
Commit: invoke /inki:commit to stage and write a commit message.
Push: invoke /inki:push (with explicit confirmation).
PR: invoke /inki:pr to draft and open the PR.

Interactive (`AUTO=false`, default)

The user confirms at each gate. If any sub-step fails or the user cancels, stop immediately.

Auto (`AUTO=true`)

Pass --non-interactive to each sub-skill that supports it. The chain runs without prompts. If any sub-skill genuinely needs a decision that isn't trivially auto-derivable (e.g., branch prefix is ambiguous and no hint was provided), it will still ask. --non-interactive skips confirmations, not informed decisions.

The safety bracket from pr-fix does NOT apply here, because /inki:submit operates only on the current branch (single PR scope by construction).

Rules

Always invoke the sub-skills; never substitute raw git / gh commands for them. Each of branch, commit, push, and PR is delegated to /inki:branch, /inki:commit, /inki:push, /inki:pr respectively. Running git commit, git push, or gh pr create by hand instead is a defect, even when it appears to produce the same result: it bypasses checks and additions the sub-skills own (branch-prefix validation, commit-message rules, the /inki:pr Vercel preview link, draft-PR defaults). --non-interactive removes confirmation prompts; it does NOT authorize bypassing the sub-skills. The only direct git/gh allowed here is read-only inspection (git status, git rev-parse, gh pr view) to decide what to pass to a sub-skill.
If any sub-step fails, stop. Do not skip a step.
Pass through the issue reference (if any) to /inki:pr.
In AUTO=true mode, surface a summary at the end showing branch name, commit SHA, and PR URL.