refresh

name	refresh
description	Headless refresh for a gh-profile-managed profile repo — rewrite the summaries sidecar (.github/profile-summaries.json) from real commit and release data so the activity and shipped sections carry one-line summaries, re-render the marker sections, refresh prose when activity warrants it, and push one commit. Use when running inside the profile repo's scheduled Claude workflow (profile-claude-refresh.yml) or when asked to refresh profile summaries.
allowed-tools	Bash(gh:*, git:*, python3:*, date:*), Read, Write, Edit, Glob, Grep

Profile refresh (headless)

The daily CI pass for a profile repo the gh-profile skill composed. The committed Python updater owns the numbers (every marker interior, refreshed mechanically every 6 hours); this pass owns the words: the one-line summaries that turn Pushed to [cc-review] into Pushed to [cc-review] — built the realtime inline-comment web UI, plus the prose outside the markers. Non-interactive by design — never ask questions, never wait for confirmation; if a step can't proceed, print why and stop.

This skill is a thin wrapper over the repo-summaries plugin's refresh skill: the sidecar choreography and its hard rules — style core, flattery law, reuse-before-rewrite, deterministic bytes, never invent — live in /repo-summaries:refresh; this wrapper supplies gh-profile's config and the profile-specific steps (prose pass, taste budget, commit). The worked section markup lives in this plugin (${CLAUDE_PLUGIN_ROOT}/skills/gh-profile/reference/blueprint.md). The profile repo's PROFILE_GUIDE.md, if present, holds only per-user overrides and wins over the defaults.

Work the steps in order.

1 — Guard

The cwd must be a profile-repo checkout: README.md exists, its line 1 is a <!-- gh-profile:meta {...} --> comment, it contains <!-- gh-profile:start: markers, and .github/scripts/update_profile.py exists. Anything missing → print what and stop; this skill never bootstraps.

2 — Refresh the sidecar (the shared pass)

Apply the /repo-summaries:refresh choreography — read its SKILL.md and follow steps 1–5 (the commit stays here, step 4 below). If the repo-summaries plugin isn't installed, this marketplace ships it alongside gh-profile: read the sibling skill at ${CLAUDE_PLUGIN_ROOT}/../repo-summaries/skills/refresh/SKILL.md.

The config: .github/summaries.config.json if the repo has one, else this plugin's template at ${CLAUDE_PLUGIN_ROOT}/skills/gh-profile/templates/github/summaries.config.json (repos composed before gh-profile 0.3.0 don't carry the file; the template is the same config). It sets the sidecar path (.github/profile-summaries.json), the two groups — activity (keys <EventType>:<owner/repo>, as_of = push head sha or event date) and shipped (keys <repo>@<tag>) — their raw-material recipes (harvest the dossier via python3 .github/scripts/update_profile.py harvest, then commit subjects and release content via gh api), the render command, and the 10-day staleness window.

Two profile-specific checks on the shared pass:

• The render command prints NOMARKER <id> when a marker pair is broken — stop and report; never patch markers from this skill.
• After rendering, python3 .github/scripts/update_profile.py update --check must exit 0 (idempotence: the sidecar is just another deterministic input).

3 — Prose pass (only when activity warrants it)

If the dossier shows material change — new repos since the prose was written, shifted clusters, a "Now" section that no longer matches the recent activity — refresh the prose (worked markup per section in ${CLAUDE_PLUGIN_ROOT}/skills/gh-profile/reference/blueprint.md): rewrite the "Now" bullets from recent activity, punch up one-liners for repos that appeared since the last pass, recategorize "More things I built" if the clusters shifted. Honor PROFILE_GUIDE.md overrides first.

Invariants, non-negotiable:

• Never edit inside <!-- gh-profile:start:<id> --> / <!-- gh-profile:end:<id> --> interiors — the updater owns them.
• The line-1 meta comment survives byte-for-byte; never change thresholds unasked.
• Taste budget: ≤ 1 animated element above the fold, ≤ 2 stat widgets, 2-item minimum per section, ≤ 1 emoji per heading.
• Every fact traces to the dossier.

If nothing material changed, change nothing — don't churn words daily for their own sake.

4 — Commit & push

One commit, staged precisely:

git add README.md .github/profile-summaries.json
git commit -m "chore: refresh profile summaries and prose"
git pull --rebase && git push

This run can race the 6-hourly mechanical refresh: if the push rejects or the rebase touches README.md, re-run the render command once and push again. Exit criteria: pushed, update --check exits 0 on the pushed state.