site-updates

Curates git history into concise thematic entries for a project journal timeline.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/robritacca-dotcom/design-system --skill site-updates-robritacca-dotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-updates
Source: https://github.com/robritacca-dotcom/design-system/tree/main/.claude/skills/site-updates
Command: npx skills add https://github.com/robritacca-dotcom/design-system --skill site-updates-robritacca-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a public project journal current is tedious: someone must read weeks of commits, decide what actually matters, and write readable summaries. This Skill automates that biweekly loop while keeping a human in the approval seat. ## Core Features & Use Cases - Commit-to-theme curation: Reads git history since the last curated bookmark and consolidates commits into one or two plain-English thematic entries, never raw commit digests. - Editorial standards enforcement: Applies strict rules for titles, body length, arc continuation, and omission of themeless chores so the timeline stays skimmable. - Safe branch-based workflow: Builds changes in a temporary git worktree on a dated branch, runs the validator and website build, and hands off a report for approval without pushing, merging, or deploying. - Use Case: A maintainer runs the biweekly loop to turn two weeks of design-system commits into a single journal entry like "The design system publishes to npm", reviewed and merged by a human. ## Quick Start Ask the assistant to update the project journal by running the site updates loop.

Frequently Asked Questions about site-updates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a project journal from git history automatically?

Run the site updates loop, which reads commits since the last curated bookmark using git log, clusters them into themes, and writes one concise entry per theme into the site-updates JSON data file on a review branch.

How to summarize git commits into readable changelog entries?

Group commits by theme rather than listing them individually, write plain descriptive titles for non-technical readers, and keep bodies to one short paragraph stating what shipped and when. Omit themeless chores like typo fixes and dependency bumps.

Does the site updates loop push or deploy changes automatically?

No. The loop works on a local branch in a temporary git worktree, runs the validator and website build, then hands off a report. A human must merge the branch to approve; nothing is pushed, merged, or deployed automatically.

What happens when there is nothing new worth recording?

If fewer than about twelve days have passed since the last entry or the new commits are only themeless chores, the loop stops and reports that nothing is worth recording yet. A no-op run is treated as a valid outcome.

Why does the site updates branch fail CI after adding an entry?

The website build regenerates tracked files such as the chat corpus that embeds journal entries. If the regenerated files are not committed alongside the data change, the CI drift guard fails, so commit all regenerated files in the same commit.