small-scripts

A collection of small, standalone utility scripts for daily use. Scripts are symlinked into ~/sbin for PATH availability.

Approach

This project uses spec-driven development (OpenSpec) as a testbed for agent-driven development and refinement:

1. Every script starts with a spec in specs/
2. Every script supports --dryrun to preview actions without side effects
3. Every script has a test in tests/ that validates dryrun behaviour against the spec

Scripts

Script	Purpose	Status
git-status-report	Recursive git repo status with diff stats	Done
md-to-docx	Markdown to DOCX conversion	Done
claude-profile	Claude Code profile management	Done
unreflected-logs	Scan projects for unreflected session logs	Done
validate-skill	Validate SKILL.md files against known Claude Code restrictions	Done

Quick Start

# Run all tests
./tests/run-all.sh

# Symlink a script into ~/sbin
ln -sf "$(pwd)/scripts/<name>" ~/sbin/<name>

Milestones

#	Description	Status
M1	Project setup, first script	In progress