---
name: docxology/template-shell
source: https://app.decimal.ai/s/docxology-template-shell@1/SKILL.md
source_sha256: e3e06788a5e3
---

# template-shell

Shell helper scripts for the template framework.

## When to use

Load this skill when you need to:
- Run the system health check before a pipeline run
- Reproduce CI locally
- Configure or run backup scripts
- Understand the shell bootstrap sourced by `run.sh`

## Key scripts

| Script | Purpose |
|--------|---------|
| `scripts/shell/health-check.sh` | Pre-flight check (Python, uv, disk, Docker, repo) |
| `scripts/shell/ci_local.sh` | Local CI reproduction |
| `scripts/shell/shell_bootstrap.sh` | uv bootstrap + sandbox env vars |
| `scripts/shell/bash_utils.sh` | Shared helpers (do not source directly in pipeline) |

## Pitfalls

- `shell_bootstrap.sh` is sourced by `run.sh` — do not alter its `export` names.
- `bash_utils.sh` is for backup/health scripts and integration tests only.
- Backup scripts assume rsync is available and the `BACKUP_DEST` env var is set.