squeaky-clean

Execute an end-of-session cleanup checklist with typechecks, Git status, and pushes.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/mbriggsy/ai-learning-journey --skill squeaky-clean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squeaky-clean
Source: https://github.com/mbriggsy/ai-learning-journey/tree/main/projects/skills/squeaky-clean
Command: npx skills add https://github.com/mbriggsy/ai-learning-journey --skill squeaky-clean

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

End-of-session cleanup ensures the workspace is returned to a known, validated state by executing a fixed, ordered checklist: update artifacts, run typechecks, verify Git status, clean temporary files, commit, and push. It prevents drift between sessions and guarantees a reproducible end state.

Core Features & Use Cases

  • Update TODO.md when present to reflect reality: current state, next steps, landmines with exact prescriptions.
  • Run Typechecks using the project's configured tool (e.g., pnpm typecheck, tsc, mypy) and halt on failures.
  • Verify Git Status to ensure only expected files are changed and no credentials or large binaries are committed.
  • Clean Temp Files by removing contents of temp/ and related artifacts while preserving the directories.
  • Check for Doc Drift by scanning markdown changes for consistency with the current state.
  • Commit changes with descriptive messages and enforce repository conventions.
  • Push changes to origin and perform a final verification.

Quick Start

Execute the squeaky-clean skill from the project root to run the cleanup checklist, performing typechecks, git status verification, temp cleanup, commits, and pushes.

Frequently Asked Questions about squeaky-clean

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

FAQPage Schema
How do I automate end-of-session git cleanup and typechecks?

Automate end-of-session git cleanup by running a fixed checklist that executes typechecks, verifies Git status, cleans temporary files, commits changes, and pushes to origin. This ensures your workspace returns to a validated, reproducible state.

What is the best way to verify Git status and prevent committing untracked artifacts?

Verify Git status and prevent committing untracked artifacts by executing an automated checklist that inspects changed files, removes temporary directory contents, and guards against credentials or large binaries before committing.

How do I check for doc drift and update TODO.md during post-session cleanup?

Check for doc drift and update TODO.md during post-session cleanup by scanning markdown changes for consistency and rewriting TODO files to reflect current state, next steps, and landmines with exact prescriptions.

Does this cleanup automation work with my project's configured typecheck tool?

This cleanup automation works with your project's configured typecheck tool, executing commands like pnpm typecheck, tsc, or mypy, and will halt the session cleanup process immediately if any typecheck failures are detected.

What happens to temporary files when I run post-session cleanup?

When running post-session cleanup, temporary files are removed by deleting the contents of the temp directory and related artifacts while preserving the directory structures themselves for future development use.