Skills sheet-git
Use when a persisted `agent-sheet` workspace needs versioning, review-session workflow, or hosted/origin sync through `sheet-git`, rather than direct workbook editing.
install
source · Clone the upstream repo
git clone https://github.com/dream-num/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/dream-num/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/sheet-git" ~/.claude/skills/dream-num-skills-sheet-git && rm -rf "$T"
manifest:
skills/sheet-git/SKILL.mdsource content
sheet-git
sheet-git is the Git-like control plane for persisted agent-sheet workspaces.
Use
agent-sheet to create or edit workbook content. Use sheet-git after the workbook changes are already persisted and the task becomes versioning, review, or sync.
Use when
- capturing persisted workbook changes into repo history
- inspecting repo state, diff, history, or blame
- creating or updating a review session
- publishing a review session to hosted review
- reading machine-readable review feedback
- syncing local state with origin
Do not use when
- the workbook still needs to be edited, attached, or persisted
- the task is only about
authoring workflowsagent-sheet - you are about to invent Git-like commands that are not in the real command surface
Core model
- local history is commit-based
- local history is
commit - local review attempt is
review session - hosted thread reuse is decided by
push review - local durable truth is only
review session - there is no local
commandapprove - hosted review is separate from origin materialization
- recovery goes through the existing
/fetch
/pull
surfacepush origin --resume
is not part of the current command surfacerebase origin
Default flow
- Ensure workbook edits are already persisted in
.agent-sheet - Run
.sheet-git status - Stage with
orsheet-git stage --entry-id <id>
.sheet-git stage --all - Inspect with
.sheet-git diff - Commit with
.sheet-git commit --message "..." - Create a review session with
.sheet-git review create
Common routes
Start from an existing hosted repo
sheet-git clone <owner>/<repo> --base-url <base-url>sheet-git clone <host>/<owner>/<repo>sheet-git clone <review-url>
Here
{owner}/{repo} is the hosted review scope for this scenario. It does not need to be pre-created; if the scenario has no existing scope yet, choose stable values and reuse them consistently.
Publish for review
sheet-git push review <session>
Read review feedback
sheet-git review status <session>sheet-git review comments <session>
Sync with origin
sheet-git fetch origin <entry-id>sheet-git pull origin <session-or-entry-id>sheet-git push origin <session>sheet-git push origin --skip-review-check <session>sheet-git push origin --resume <replay-run>
By default,
sheet-git push origin <session> checks hosted approval before replaying. Use --skip-review-check only when you need the explicit bypass path.
Follow refusal output literally. If
sheet-git tells you the next safe command, use that instead of improvising.
Primary commands
| Task | Command |
|---|---|
| initialize repo | |
| bind hosted review scope | |
| inspect state | |
| inspect diff | |
| stage changes | / |
| commit | |
| inspect history | |
| inspect one revision | |
| create review session | |
| inspect review session state | |
| publish to hosted review | |
| read review comments | |
| preview origin materialization | |
| materialize to origin | |
| bypass hosted review check | |
| resume interrupted replay | |
| inspect remote-ahead state | |
| pull remote changes locally | |
| bind an existing origin workbook | |
| inspect one cell | |
Naming discipline
- the command is
, nothistorylog - the hosted handoff command is
push review - use
andclone
as documented; do not invent alternate namesremote add review
/--owner
define the hosted review scope for this scenario--repo- if the scenario has no pre-existing hosted scope, pick stable values and keep reusing them
- do not ask for or simulate
rebase origin
References
- references/command-surface.md: exact commands and naming
- references/hosted-review.md: hosted review collaboration
- references/recovery.md: refusal handling and recovery paths