Skip to content
cccskills
FreePublished on GitHub

update-project-docs

Use when the user says /update, @update, update project docs, or asks to sync task.md, changelog.md, and files.md after completing work.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Update project docs

Sync project tracking files after completing work, then provide the commit message as plain copyable text (no git command).

Activate with: /update, @update, update project docs, or sync project docs.

Step 1: Get real dates and see what changed

Run these together:

git log --date=short -n 10
git diff --stat

Use actual commit dates. Never use placeholder dates or future months. The diff stat tells you which files changed so the changelog and commit message are accurate.

Step 2: Update task.md

Move completed items from ## To Do or ## In Progress into ## Recently Completed with a timestamp:

- YYYY-MM-DD HH:mm UTC - Short description of what was done. PRD: prds/slug.md (if one exists).

If new work is queued, add it under ## To Do.

Step 3: Update changelog.md

Follow https://keepachangelog.com/en/1.0.0/ format. Add the new entry under ## [Unreleased]:

### Added
- What was added with key details (YYYY-MM-DD).

### Changed
- What changed and why (YYYY-MM-DD).

### Fixed
- Bug description and resolution (YYYY-MM-DD).

Use real dates from git log. Add timestamps in parentheses when it helps distinguish same day entries.

Step 4: Update files.md

Only update if new files were added, files were renamed, or existing descriptions are outdated.

  • Add new files to the correct section
  • Update descriptions for renamed or changed files
  • Keep descriptions to one sentence, no emoji

Step 5: Generate a git commit message

After syncing all docs, output the commit message as plain text only. No git add, no git commit, no cat <<'EOF' wrapper, no shell at all. Just the message in a plain code block so it is easy to copy. Format:

<type>: <short summary of the main change>

<optional body: 1-3 bullets covering what changed>

Type must be one of: feat, fix, docs, style, refactor, test, chore.

Rules for the commit message:

  • Output only the message text, never a git command
  • Present tense ("add feature" not "added feature")
  • Subject line under 50 characters
  • No period at the end of the subject
  • Body bullets only when the change touches more than two concerns
  • If the session was purely a docs sync with no code changes, use docs: sync task, changelog, and files

Checklist

Before calling this done:

  • git log and git diff --stat run to get real dates and changed files
  • task.md updated with completed items and timestamps
  • changelog.md new entry added with real dates
  • files.md updated if files were added, renamed, or changed
  • Commit message printed as plain text for the user to copy

Notes

  • This skill applies to this project. If the project does not have these exact files, adapt the steps to whatever tracking files exist.
  • Do not create README.md, CONTRIBUTING.md, or other documentation files unless explicitly requested.
  • Do not run git commit yourself, and do not output any git command. Print only the plain commit message text and let the user copy it.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adapt

Free

Adapt designs to work across different screen sizes, devices, contexts, or platforms. Implements breakpoints, fluid layouts, and touch targets. Use when the user mentions responsive design, mobile layouts, breakpoints, viewport adaptation, or cross-device compatibility.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

Agent Ready project design context for navigation, docs links, and interface tone. Use when building or reviewing UI in this repo so patterns match the documented product feel.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. Use when the user mentions adding animation, transitions, micro-interactions, motion design, hover effects, or making the UI feel more alive.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

audit

Free

Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

The English summary is being prepared. Showing the original description.

waynesutton/waynesutton-ai2Updated Sep 8, 2026

See all skills by waynesutton

Report a problem with this skill