run-agent-skillslisted

This repo is a Bun workspace of Markdown-defined skills/agents/rules plus a handful of Bash hooks and one TypeScript helper. There is no app to "launch" — driving it means running the validation pipeline (`bun run validate`) and exercising the Claude Code hooks by piping JSON to their stdin. All paths below are relative to the repo root. ## Prerequisites ```bash brew install bats-core shellcheck jq curl -fsSL https://bun.sh/install | bash # or: brew install oven-sh/bun/bun ``` Versions confirmed working: `bun 1.3.13`, `bats 1.13.0`, `shellcheck 0.11.0`, `jq 1.7.1`. ## Setup ```bash bun install ``` Installs `markdownlint-cli` and `yaml` into root `node_modules/`. The workspace members (`skills/`, `agents/`, `rules/`) have empty deps — `bun install` finishes in ~50ms when already populated. ## Run (agent path) The full validation pipeline — lint markdown, lint shell, run bats, check indexes, check README links: ```bash bun run validate ``` Each step is also addressable individually (and is what you want when iterating): | command | what it does | exit code | |---|---|---| | `bun run lint` | markdownlint on all `**/*.md` | 1 on findings | | `bun run lint:fix` | markdownlint --fix on all `**/*.md` | 1 on un-fixable findings | | `bun run lint:sh` | shellcheck on `.claude/hooks/*.sh hooks/*.sh scripts/*.sh skills/symlink-skills/link.sh` | 1 on findings | | `bun run test` | bats over `.claude/hooks/tests/ hooks/tests/ scripts/tests/ skills/symlink-skills/tests/` | non-