github-ops

name	github-ops
description	Use when working with GitHub repos, branch setup, auth tokens, PR flow, or repo preparation inside Reef.

GitHub Operations

Use this skill when the task involves cloning or preparing a repo, branching, pushing, opening PRs, or working with GitHub-scoped auth.

Goal

Treat GitHub workflow as a procedure, not as part of the always-on constitution.

Repo Preparation

Before proposing architecture or decomposition:

• use reef_git_prepare to clone or prepare the repo if Reef already has a helper for it
• then use ls or tree
• inspect top-level files
• identify language, package manager, build system, and test entrypoints
• read the README and key manifests

Do not start with a long self-briefing. Start by preparing and understanding the repo.

Auth

Use reef_github_token with the narrowest profile that does the job:

• read for inspection
• develop for branches, pushes, and normal implementation work
• ci only when CI-scoped operations are actually needed

Do not mint broad credentials casually.

Branch Discipline

• never push directly to main
• prepare a task branch before meaningful implementation work
• use clear branch names that reflect the slice of work
• keep save points before risky refactors or large integration steps

PR Discipline

When the work is PR-shaped, provide enough for a parent or operator to continue cleanly:

• branch name
• commit(s)
• tests run and results
• unresolved risks
• PR URL if created

If a PR is not ready, say what is missing instead of implying completion.

Relationship To Other Skills

• use skills/code-delivery/SKILL.md for implementation, testing, and parent-friendly receipts
• use skills/decompose/SKILL.md when the repo task needs recursive delegation
• use skills/reporting-checkpointing/SKILL.md when reporting upward after GitHub/code work