agentleFS
joris887joris887/exosuit/.claude/skills/wrap-up/SKILL.md

wrap-up

Skill9 starsChanged 3 months agoMITView on GitHub

Use when the user is about to leave a session (closing the laptop, locking the phone, "wrap up", "I'm off"). First checks whether anything could be lost; when nothing can, says "you're all set to leave" and does nothing else. Otherwise commits, pushes and opens a PR, and only with the user's yes merges and deploys.

  • Commits and pushes

62 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use refine, sync and 7 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AlexPEClubSkill

    refine

    Always use when the user wants to discuss an exsiting feature or specification. Open an existing feature spec to improve, extend, or fundamentally challenge it. Pass the feature ID as argument (e.g. /refine PROJ-2).

    Also in 3 projects that use this

  • MicrosoftSkill

    sync

    Sync the current session branch with its upstream branch, or publish the current session branch to a remote. Use when the user asks to sync a branch, pull latest changes, rebase onto upstream, push current branch, publish branch, or set upstream.

    Also in 3 projects that use this

  • austintgriffithSkill

    orchestration

    Use when a Scaffold-ETH 2 build leaves localhost: planning the launch order, deploying and verifying contracts on a live network, standing up a fork of a real chain to rehearse a deploy, or fixing a contract bug that is already onchain. Not for running the app or a demo against that fork (`/frontend-playbook`).

    Also in 3 projects that use this

  • SentrySkill

    spec

    Produce a verified spec — problem, desired outcome, and acceptance criteria — before building. Use when given a GitHub/Linear issue link, when starting from a fuzzy in-conversation idea, or asked to "figure out what to do" / "scope this" / "what should I build" — whenever the *what* isn't yet pinned down. Grills the ambiguities, checks the premise against the code, and produces acceptance criteria you sign off on — then hands to design-first.

    Also in 5 projects that use this

  • OpenAISkill

    security-scan

    Use for a standard, single-pass security audit of an entire repository or a scoped path, package, folder, or submodule with no diff to review. This is the default repository scan. Do not use for PR, commit, branch, or working-tree diffs, or for deep, multi-pass scans.

    Also in 3 projects that use this

  • seikaikyoSkill

    interview-me

    需求不明時的意圖萃取訪談:一次一題、每題附上自己的猜測、聽出「真正想要 vs 覺得應該要」,直到能預測使用者反應(約 95% 信心)才動工。適用:需求缺少對象 / 動機 / 成功標準 / 約束,或使用者點名「訪談我」「先確認一下」「我們確定嗎」。明確自足的指示、純資訊查詢、機械性操作不適用。

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 57 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Very specific:

    Add one line per note the script printed (an open PR for this branch, LANE, ELSEWHERE, GONE, STASH), in plain words.

    line 40
  2. Distinctive:

    Only in this worktree. Never commit in another worktree: a lane's Claude Code may be working there.

    line 59
  3. Distinctive:

    Never commit on the default branch.

    line 64
  4. Very specific:

    Never --force. A rejected push: stop and report it.

    line 73
  5. Very specific:

    A PR: when the branch is not the sprint branch, not a lane and has none, ask whether to open one (gh pr create --fill.

    line 74
  6. Distinctive:

    Run the check again and report:

    line 80
  7. Distinctive:

    Ask: "Merge and deploy now?" On no, stop: the PR waits.

    line 87
  8. Distinctive:

    Never commit on the default branch, never force-push, never merge without the user's yes, never merge failing CI.

    line 120
  9. Distinctive:

    Never commit, stash or reset in another worktree.

    line 122

“Common” is measured: kept by at least 6 in 10 of the 57 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

wrap-up

Skill metrics: Emit a start event to the activity log:

echo "{\"type\":\"skill\",\"event\":\"start\",\"skill\":\"wrap-up\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" >> docs/sessions/.activity-log.jsonl

"All set to leave" means: nothing uncommitted in this worktree, and every branch that is not a lane on a remote. Most of all on a server you reach from a phone, where work left uncommitted is easy to forget. Deploying is an optional last step.

Step 1: Can anything be lost? (always first)

bash "${CLAUDE_PLUGIN_ROOT:-.claude}/skills/wrap-up/scripts/wrap-up-check.sh"
gh pr view --json number,url,state 2>/dev/null || true

The script changes nothing. Its last line is the verdict:

  • VERDICT all-set: stop here and report exactly:
    ✅ You're all set to leave.
    Working tree clean, nothing unpushed.
    Add one line per note the script printed (an open PR for this branch, LANE, ELSEWHERE, GONE, STASH), in plain words. Run none of the steps below.
  • VERDICT to-save: go on to Step 2.

What each line means:

LineMeaning
UNCOMMITTEDchanges in this worktree that no commit holds
UNPUSHEDa branch with commits no remote has
DETACHEDcommits on no branch at all
NO-REMOTEthe repository cannot be pushed anywhere
LANEa lane or stream; it merges into its parent locally with /merge-up
ELSEWHEREanother worktree with uncommitted work; its own session commits there
GONEthe branch's remote branch was deleted, usually after a merge
STASHstashed changes, kept on this machine only

Step 2: Save the work

Only in this worktree. Never commit in another worktree: a lane's Claude Code may be working there.

  1. On the default branch or a detached HEAD: move onto a new branch first, named <type>/<description> from the diff (git rules): git switch -c <name>. Never commit on the default branch.
  2. Commit what is uncommitted: a Conventional Commit that sums up the diff. Show the message, then git add -A && git commit -m "<message>".
  3. Push, unless this is a lane or stream branch (git config branch.<name>.exosuitParent is set): those merge up locally, so say "committed in the lane; run /merge-up when the story is done".
    git push -u origin "$(git branch --show-current)"
    Never --force. A rejected push: stop and report it.
  4. A PR: when the branch is not the sprint branch, not a lane and has none, ask whether to open one (gh pr create --fill; ask for the base when it is not the default branch).
  5. Other UNPUSHED branches: list them and ask before pushing each one.
  6. No remote (NO-REMOTE): say so; nothing can be pushed until one is added.

Run the check again and report:

✅ Your work is safe: committed and pushed on <branch> (PR #<n>).

Step 3: Ship it now? (optional)

Ask: "Merge and deploy now?" On no, stop: the PR waits.

On yes:

  • A sprint branch is shipped by /sprint-end, with its gates. Say so and stop.
  • Otherwise wait for CI, then squash-merge:
    gh pr checks --watch
    gh pr merge --squash --delete-branch
    Failing CI: stop, nothing is merged; the work is safe on its branch.
  • Deploy with /deploy, or the deploy command the project's CLAUDE.md names, then its health check. A project with no deploy: report the merge and stop.
  • A database migration in the diff: say before the merge that the deploy applies it and that it does not roll back.

Report

## Wrap-up
- Work: committed and pushed on <branch> (PR #<n>) | already safe
- Shipped: merged and deployed, health ok | not shipped, PR #<n> open
- Notes: <LANE / ELSEWHERE / GONE / STASH lines, in plain words>

✅ You're all set to leave.
echo "{\"type\":\"skill\",\"event\":\"end\",\"skill\":\"wrap-up\",\"outcome\":\"success\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" >> docs/sessions/.activity-log.jsonl

Rules

  • Step 1 always runs first, and an all-set verdict ends the skill.
  • Never commit on the default branch, never force-push, never merge without the user's yes, never merge failing CI.
  • Never commit, stash or reset in another worktree.
  • For notes on what was done and what is next, /handoff writes the session file; /wrap-up only makes sure nothing is lost.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.