# 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

```bash
# 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 |