agent-loadout 1.0.2 → 1.2.0

package/dist/{catalog-PTLCQEDW.js → catalog-7NB7RALT.js}

@@ -6,7 +6,7 @@ import {
   getToolsByIds,
   getToolsByPreset,
   validateToolIds
-} from "./chunk-JYIPAISH.js";
+} from "./chunk-HDF2R3CI.js";
 export {
   PRESETS,
   TOOLS,

package/dist/{chunk-JYIPAISH.js → chunk-HDF2R3CI.js}

@@ -17,7 +17,13 @@ var PRESETS = [
   {
     id: "media",
     name: "Media",
-    description: "Image, audio, and video pipeline tools",
+    description: "Audio, video, and image pipeline tools",
+    defaultOn: false
+  },
+  {
+    id: "design",
+    name: "Design",
+    description: "Visual asset workflows \u2014 SVG, colour, and image preview",
     defaultOn: false
   },
   {
@@ -359,6 +365,54 @@ var TOOLS = [
     tags: ["interactive shell", "tui prompt", "user input", "shell script ui", "confirm dialog"],
     seeAlso: ["fzf", "just"]
   },
+  {
+    id: "oha",
+    name: "oha",
+    description: "HTTP load tester with JSON output",
+    preset: "agent",
+    verify: "oha --version",
+    install: brewScoopCargo("oha", "oha"),
+    tags: ["load test", "http benchmark", "stress test", "api performance", "latency"],
+    seeAlso: ["xh", "hyperfine"]
+  },
+  {
+    id: "gron",
+    name: "gron",
+    description: "Flatten JSON for grepping",
+    preset: "agent",
+    verify: "gron --version",
+    install: {
+      darwin: [{ method: "brew", package: "gron" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "gron" }]
+    },
+    tags: ["json grep", "flatten json", "json search", "json path", "json debug"],
+    seeAlso: ["jq", "fx", "duckdb"]
+  },
+  {
+    id: "lychee",
+    name: "lychee",
+    description: "Fast link checker",
+    preset: "agent",
+    verify: "lychee --version",
+    install: brewScoopCargo("lychee", "lychee"),
+    tags: ["link check", "broken links", "url validation", "documentation", "dead links"],
+    seeAlso: ["xh", "typos", "vale"]
+  },
+  {
+    id: "vale",
+    name: "vale",
+    description: "Prose linter for docs",
+    preset: "agent",
+    verify: "vale --version",
+    install: {
+      darwin: [{ method: "brew", package: "vale" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "vale" }]
+    },
+    tags: ["prose lint", "writing style", "documentation quality", "grammar", "technical writing"],
+    seeAlso: ["typos", "lychee", "pandoc"]
+  },
   // ── Media ─────────────────────────────────────────────
   {
     id: "ffmpeg",
@@ -392,17 +446,104 @@ var TOOLS = [
     verify: "magick -version",
     install: universal("imagemagick"),
     tags: ["image resize", "image convert", "image transform", "thumbnail", "crop image"],
-    seeAlso: ["exiftool", "svgo", "ffmpeg"]
+    seeAlso: ["exiftool", "vips", "ffmpeg"]
+  },
+  {
+    id: "vips",
+    name: "libvips",
+    description: "Fast image processing pipeline",
+    preset: "media",
+    verify: "vips --version",
+    install: {
+      darwin: [{ method: "brew", package: "vips" }],
+      linux: [{ method: "apt", package: "libvips-tools" }],
+      win32: null
+    },
+    tags: ["image processing", "batch images", "resize", "thumbnail", "sharp backend"],
+    seeAlso: ["imagemagick", "resvg"]
   },
+  // ── Design ─────────────────────────────────────────────
   {
     id: "svgo",
     name: "svgo",
     description: "SVG optimiser",
-    preset: "media",
+    preset: "design",
     verify: "svgo --version",
     install: npmAll("svgo"),
     tags: ["svg optimize", "svg compress", "vector graphics", "svg minify", "icon optimize"],
-    seeAlso: ["imagemagick"]
+    seeAlso: ["resvg", "imagemagick"]
+  },
+  {
+    id: "resvg",
+    name: "resvg",
+    description: "High-fidelity SVG renderer",
+    preset: "design",
+    verify: "resvg --version",
+    install: {
+      darwin: [{ method: "brew", package: "resvg" }],
+      linux: [{ method: "cargo", package: "resvg" }],
+      win32: null
+    },
+    tags: ["svg render", "svg to png", "vector graphics", "svg rasterize"],
+    seeAlso: ["svgo", "vips"]
+  },
+  {
+    id: "chafa",
+    name: "chafa",
+    description: "Image-to-ANSI art renderer",
+    preset: "design",
+    verify: "chafa --version",
+    install: {
+      darwin: [{ method: "brew", package: "chafa" }],
+      linux: [{ method: "apt", package: "chafa" }],
+      win32: null
+    },
+    tags: ["image preview", "terminal image", "ansi art", "image in terminal"],
+    seeAlso: ["vips", "imagemagick"]
+  },
+  {
+    id: "pastel",
+    name: "pastel",
+    description: "Color manipulation and palette tool",
+    preset: "design",
+    verify: "pastel --version",
+    install: brewScoopCargo("pastel", "pastel"),
+    tags: ["color", "palette", "design tokens", "color convert", "color inspect"],
+    seeAlso: ["chafa", "bat"]
+  },
+  {
+    id: "d2",
+    name: "d2",
+    description: "Declarative diagramming language",
+    preset: "design",
+    verify: "d2 version",
+    install: {
+      darwin: [{ method: "brew", package: "d2" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "d2" }]
+    },
+    tags: ["diagram", "architecture diagram", "flowchart", "svg generation", "documentation"],
+    seeAlso: ["resvg", "svgo", "pandoc"]
+  },
+  {
+    id: "pngquant",
+    name: "pngquant",
+    description: "Lossy PNG compressor",
+    preset: "design",
+    verify: "pngquant --version",
+    install: universal("pngquant"),
+    tags: ["png compress", "image optimize", "lossy compression", "web assets"],
+    seeAlso: ["oxipng", "svgo", "imagemagick"]
+  },
+  {
+    id: "oxipng",
+    name: "oxipng",
+    description: "Lossless PNG optimizer",
+    preset: "design",
+    verify: "oxipng --version",
+    install: brewScoopCargo("oxipng", "oxipng"),
+    tags: ["png optimize", "lossless compression", "image optimize", "web assets"],
+    seeAlso: ["pngquant", "svgo", "imagemagick"]
   },
   // ── DX ────────────────────────────────────────────────
   {
@@ -587,6 +728,44 @@ var TOOLS = [
     tags: ["toml", "toml lint", "toml format", "config validation", "cargo toml"],
     seeAlso: ["yq", "biome"]
   },
+  {
+    id: "fx",
+    name: "fx",
+    description: "Interactive JSON viewer",
+    preset: "dx",
+    verify: "fx --version",
+    install: {
+      darwin: [{ method: "brew", package: "fx" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "fx" }]
+    },
+    tags: ["json viewer", "interactive json", "json explorer", "json filter"],
+    seeAlso: ["jq", "bat"]
+  },
+  {
+    id: "csview",
+    name: "csview",
+    description: "CSV/TSV viewer with column alignment",
+    preset: "dx",
+    verify: "csview --version",
+    install: brewScoopCargo("csview", "csview"),
+    tags: ["csv", "tsv", "tabular data", "spreadsheet", "data viewer"],
+    seeAlso: ["duckdb", "jq"]
+  },
+  {
+    id: "asciinema",
+    name: "asciinema",
+    description: "Terminal session recorder",
+    preset: "dx",
+    verify: "asciinema --version",
+    install: {
+      darwin: [{ method: "brew", package: "asciinema" }],
+      linux: [{ method: "apt", package: "asciinema" }],
+      win32: null
+    },
+    tags: ["terminal recording", "demo", "screen capture", "documentation"],
+    seeAlso: ["bat", "glow"]
+  },
   // ── Security ──────────────────────────────────────────
   {
     id: "trivy",

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   getToolsByIds,
   getToolsByPreset,
   validateToolIds
-} from "./chunk-JYIPAISH.js";
+} from "./chunk-HDF2R3CI.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -487,19 +487,25 @@ var jq_default = `
 Filter, transform, and extract data from JSON. Essential for working with API responses and config files.
 
 ## Trusted commands
-- Pretty print: \`cat file.json | jq .\`
-- Extract field: \`jq '.fieldName'\`
+- Pretty print: \`jq . file.json\`
+- Extract field: \`jq '.fieldName' file.json\`
 - Pick multiple fields: \`jq '{id, name, status}'\`
 - Map over array: \`jq '[.items[] | {id, name}]'\`
 - Count array: \`jq '.items | length'\`
 - Filter: \`jq '.items[] | select(.status == "active")'\`
 - Default for missing: \`jq '.name // "unknown"'\`
-- Validate JSON (fail on error): \`jq -e .\`
+- Validate JSON (fail on error): \`jq -e . file.json\`
+
+## Output format
+Pretty-printed JSON by default. Use \`-r\` for raw strings (no quotes). Use \`-c\` for compact single-line JSON. \`-e\` / \`--exit-status\` exits non-zero on null or false output.
+
+## Why it matters for agents
+The standard tool for parsing API responses and config files in shell pipelines. \`-e\` flag makes null checks composable: \`jq -e '.token' response.json || exit 1\`.
 
 ## Gotchas
-- Use \`-e\` flag to get non-zero exit code on null/false results.
-- Use \`-r\` for raw string output (no quotes).
-- Missing fields return null, not an error. Use \`//\` for defaults.
+- Use \`-r\` for raw string output (no quotes) \u2014 required when passing jq output to other commands.
+- Missing fields return null, not an error. Use \`//\` for defaults: \`.name // "unknown"\`.
+- Use \`-e\` to get non-zero exit code on null/false results \u2014 essential for conditional pipelines.
 `.trim();
 
 // src/skills/yq.ts
@@ -516,6 +522,9 @@ Same as jq but for YAML files. Query, filter, and transform YAML.
 - Update in place: \`yq -i '.version = "2.0"' file.yaml\`
 - Merge files: \`yq eval-all 'select(fi == 0) * select(fi == 1)' a.yaml b.yaml\`
 
+## Output format
+YAML by default. \`--output-format=json\` (or \`-o json\`) for JSON. \`--output-format=props\` for Java properties format. \`-P\` (prettyPrint) for pretty YAML from any input format.
+
 ## Gotchas
 - There are multiple tools called yq. This refers to the Go version (mikefarah/yq), installed via brew.
 - Use \`-i\` carefully \u2014 it modifies files in place.
@@ -605,16 +614,29 @@ var fzf_default = `
 # fzf \u2014 Fuzzy finder
 
 ## When to use
-Interactive fuzzy search for files, command history, git branches \u2014 anything with a list.
+Interactive fuzzy search for files, command history, git branches \u2014 anything with a list. Also useful non-interactively via \`--filter\`.
 
 ## Trusted commands
-- Find files: \`fzf\`
+- Find files interactively: \`fzf\`
 - Pipe any list: \`git branch | fzf\`
 - Preview files: \`fzf --preview 'bat --color=always {}'\`
 - With fd: \`fd -t f | fzf\`
+- Non-interactive filter (scripting): \`echo -e "foo
+bar
+baz" | fzf --filter "ba"\`
+- Multi-select: \`fzf --multi\`
+
+## Output format
+Selected line(s) written to stdout, newline-separated. Exits 130 if the user cancels (Ctrl-C or Esc) \u2014 use this to detect cancellation in scripts. In \`--filter\` mode, prints all lines that match the query and exits 0/1.
+
+## Why it matters for agents
+\`--filter\` mode makes fzf a non-interactive fuzzy matcher \u2014 pipe a list in, get filtered results out without any TUI. Useful for selecting the best match from a known set without full regex. Exit code 130 on cancel is a reliable signal in pipelines.
 
 ## Gotchas
-- Primarily interactive \u2014 less useful for non-interactive agent workflows, but great when you're driving.
+- Exit code 130 on cancel \u2014 check for this in scripts to detect user abort vs no results (exit 1).
+- \`FZF_DEFAULT_COMMAND\` sets the default input source (e.g. \`export FZF_DEFAULT_COMMAND='fd -t f'\`).
+- \`--filter\` runs non-interactively \u2014 pipe-safe for scripting without a TTY.
+- \`--multi\` outputs one selected item per line; combine with \`xargs\` for batch operations.
 `.trim();
 
 // src/skills/shellcheck.ts
@@ -663,6 +685,9 @@ Search and replace code using syntax tree patterns instead of regex. Far safer f
 - Replacing with structural awareness (e.g. moving arguments)
 - Any refactor where brackets/nesting matters
 
+## Output format
+\`file:line:col: matched text\` format by default. \`--json\` emits structured match objects with file, range, metavariable bindings, and matched text \u2014 use for programmatic processing of results.
+
 ## Gotchas
 - The binary is called \`sg\`, not \`ast-grep\`.
 - \`$ARG\` is a metavariable that matches any single node. \`$$$ARGS\` matches multiple.
@@ -704,6 +729,9 @@ Generate a regular expression from a set of example strings. Useful when you kno
 - Case insensitive: \`grex --ignore-case "Foo" "FOO" "foo"\`
 - Verbose regex: \`grex --verbose "foo-123" "bar-456"\`
 
+## Output format
+Single regex string to stdout, ready to copy-paste or pipe. No trailing newline issues \u2014 capture with \`PATTERN=$(grex ...)\` and use directly.
+
 ## Gotchas
 - Output is a raw regex string \u2014 pipe directly into \`rg\`, \`sd\`, or save to a variable.
 
@@ -725,6 +753,9 @@ Detect unused files, exports, dependencies, and types in TypeScript/JavaScript p
 - Unused deps only: \`knip --include dependencies\`
 - Machine-readable with scopes: \`knip --reporter json --include files,exports,dependencies\`
 
+## Output format
+Text report to stdout grouped by category (files, exports, dependencies). \`--reporter json\` emits a structured JSON object with arrays per category \u2014 pipe to \`jq\` to filter specific types. Exits 1 if issues found (CI-friendly).
+
 ## Why it matters for agents
 Identifies dead code before large refactors \u2014 agents can safely delete unused files and exports flagged by knip without breaking the build.
 
@@ -748,6 +779,9 @@ Find and replace in files. Like sed but with intuitive syntax \u2014 no escaping
 - Regex replace: \`sd 'v(\\d+)' 'version-$1' file.txt\`
 - Replace across files (with fd): \`fd -e ts -x sd 'old' 'new' {}\`
 
+## Output format
+Rewrites the file in-place with no stdout output. Use \`-p\` / \`--preview\` to print a diff of what would change without modifying the file \u2014 safe to run first.
+
 ## Gotchas
 - Uses regex by default. Use \`-F\` for fixed/literal strings.
 - Modifies files in place when given a filename. Use \`-p\` to preview first.
@@ -772,12 +806,17 @@ Benchmark commands to compare performance. Runs commands multiple times and repo
 - Non-interactive + export: \`hyperfine --style basic --export-json results.json 'cmd1' 'cmd2'\`
 - With prepare step: \`hyperfine --prepare 'make clean' 'make build'\`
 
+## Output format
+Human-readable table to stderr by default (mean, stddev, min, max per command). \`--export-json results.json\` writes structured JSON with full timing arrays. \`--style basic\` disables the progress bar and colour \u2014 required for clean CI logs.
+
 ## Why it matters for agents
 \`--export-json\` lets agents compare builds and commands quantitatively \u2014 structured results include mean, stddev, min, max per command.
 
 ## Gotchas
 - Wrap commands in quotes.
 - Use \`--warmup\` for commands that benefit from caching.
+- Use \`--style basic\` in CI environments \u2014 disables the progress bar and colour codes that pollute CI logs.
+- Use \`--shell=none\` to avoid shell startup overhead when benchmarking micro-operations.
 `.trim();
 
 // src/skills/tokei.ts
@@ -853,6 +892,8 @@ Read, write, and strip metadata (EXIF, IPTC, XMP) from images and media files.
 ## Gotchas
 - Field names are case-insensitive.
 - Use \`-json\` for structured output.
+- By default, modifying metadata creates a \`filename_original\` backup file \u2014 use \`-overwrite_original\` to skip backups when you're confident in the operation.
+- Without \`-overwrite_original\`, directories fill up with \`*_original\` files after batch operations \u2014 clean up with \`find . -name "*_original" -delete\`.
 
 ## Why it matters for agents
 \`-json\` output enables structured metadata extraction from any media file \u2014 agents can batch-read EXIF data, filter by GPS coordinates, or rename files by capture date programmatically.
@@ -877,7 +918,9 @@ Resize, crop, convert, and manipulate images from the command line.
 - \`magick mogrify\` modifies files in place. Use \`magick convert\` (or just \`magick in out\`) for safe transforms.
 
 ## Gotchas
-- The binary is \`magick\` (ImageMagick 7). Older versions used \`convert\`.
+- The binary is \`magick\` (ImageMagick 7). Older versions used \`convert\` \u2014 don't use \`convert\` on macOS as it shadows a system binary.
+- Always specify the output format explicitly in the filename \u2014 \`magick input.png output.jpg\` converts; omitting extension may produce unexpected formats.
+- \`mogrify\` modifies files destructively in place \u2014 always test with \`magick convert\` on a single file first, or back up the originals.
 
 ## Why it matters for agents
 Batch image processing without opening apps \u2014 useful for automated asset pipelines. Agents can resize, convert formats, and generate thumbnails in a single \`mogrify\` invocation.
@@ -920,6 +963,18 @@ List files with better defaults: colours, git status, icons, tree view built in.
 - Tree view: \`eza --tree\`
 - Tree with depth limit: \`eza --tree --level 2\`
 - All files (including hidden): \`eza -la\`
+- Machine-readable tree: \`eza --tree --json\`
+
+## Output format
+Plain text with aligned columns by default. \`--json\` emits a structured JSON tree of file entries with name, path, type, size, and permissions. \`--git\` adds a column showing each file's git status (untracked, modified, staged).
+
+## Why it matters for agents
+\`eza --tree --json\` provides a structured file tree without spawning \`find\` or parsing \`ls\` output \u2014 agents can parse it directly to navigate unfamiliar repos. \`--git\` flag surfaces repo status per-file without running \`git status\`.
+
+## Gotchas
+- Binary is named \`eza\`, not \`ls\` \u2014 aliasing \`ls=eza\` is common but optional.
+- \`--icons\` requires a Nerd Font in your terminal; omit it in CI or non-Nerd-Font sessions.
+- \`--git\` is noticeably slow on large repos (it calls libgit2 per entry) \u2014 avoid in hot loops.
 `.trim();
 
 // src/skills/zoxide.ts
@@ -929,15 +984,25 @@ var zoxide_default = `
 ## When to use
 Jump to frequently used directories without typing full paths. Learns from your usage.
 
-## Setup
-Add to ~/.zshrc: \`eval "$(zoxide init zsh)"\`
-Then use \`z\` instead of \`cd\`: \`z projects\` jumps to your most-used match.
-
 ## Trusted commands
 - Jump: \`z partial-dirname\`
-- Interactive: \`zi\` (requires fzf)
+- Interactive jump (requires fzf): \`zi\`
+- Resolve best match (no cd): \`zoxide query <term>\`
+- List all known paths with scores: \`zoxide query --list\`
 - Add path manually: \`zoxide add /path/to/dir\`
-- List known paths: \`zoxide query --list\`
+- Remove a path: \`zoxide remove /path/to/dir\`
+
+## Output format
+\`z\` emits nothing \u2014 it just changes the shell directory. \`zoxide query <term>\` prints the best-match absolute path as a plain string to stdout. \`zoxide query --list\` prints tab-separated score + path pairs, sorted by frecency.
+
+## Why it matters for agents
+\`zoxide query <term>\` returns the best-match absolute path without navigating \u2014 use it for path resolution when you know a partial name but not the full path. Avoids hardcoding paths that differ between machines.
+
+## Gotchas
+- Must be initialised in shell config: \`eval "$(zoxide init zsh)"\` in ~/.zshrc. Without this, \`z\` is unavailable.
+- Frecency scores update on each \`z\` usage \u2014 a new directory won't rank highly until visited repeatedly.
+- \`zi\` is interactive (TUI with fzf) \u2014 use \`zoxide query\` for non-interactive scripting.
+- Shell integration required: zoxide works by hooking into \`cd\`; doesn't affect subshells unless initialised there too.
 `.trim();
 
 // src/skills/delta.ts
@@ -962,6 +1027,8 @@ Add to ~/.gitconfig:
 
 ## Gotchas
 - The brew package is called \`git-delta\`, but the binary is \`delta\`.
+- Configured via \`~/.gitconfig\` (not CLI flags at runtime) \u2014 add \`[delta]\` section with options like \`side-by-side = true\`, \`line-numbers = true\`.
+- Enable with \`git config --global core.pager delta\` \u2014 without this, delta is not invoked automatically.
 
 ## Why it matters for agents
 Makes \`git diff\` and \`git log -p\` output readable \u2014 useful when agents are reviewing code changes or summarising commits for users.
@@ -977,12 +1044,21 @@ Render markdown files beautifully in the terminal. Great for reading READMEs, do
 ## Trusted commands
 - Render file: \`glow README.md\`
 - Render with pager: \`glow -p README.md\`
-- Render from stdin: \`cat CHANGELOG.md | glow\`
+- Render from stdin: \`glow -\`
 - Disable pager: \`glow --no-pager README.md\`
 - Fixed width: \`glow --width 100 README.md\`
+- Plain output (no ANSI): \`glow --style=ascii README.md\`
+
+## Output format
+ANSI-formatted markdown to stdout by default \u2014 colours, bold, tables rendered for terminal display. Use \`--style=ascii\` to strip ANSI codes for piping into other tools or log capture. Activates a pager automatically for long content.
 
 ## Why it matters for agents
-Renders markdown cleanly in terminal output \u2014 useful for displaying skill files, changelogs, or generated docs to users without raw markdown symbols.
+Renders markdown cleanly in terminal output \u2014 useful for displaying skill files, changelogs, or generated docs to users without raw markdown symbols. \`--style=ascii\` makes output safe to capture or pipe.
+
+## Gotchas
+- Pager activates by default for long content \u2014 use \`--no-pager\` in scripts to avoid blocking on stdin.
+- Output wraps at terminal width; use \`--width\` to control line length in narrow terminals.
+- Requires markdown-formatted input \u2014 feeding plain text will render as-is with no improvement.
 `.trim();
 
 // src/skills/mise.ts
@@ -1025,7 +1101,9 @@ Watch files for changes and re-run a command. Language-agnostic alternative to n
 
 ## Gotchas
 - Use \`-e\` to filter by extension, \`-w\` to filter by directory.
-- Use \`--restart\` for long-running processes (servers), otherwise it waits for completion.
+- Use \`--restart\` for long-running processes (servers) \u2014 without it, watchexec waits for the previous run to finish before starting the next.
+- Use \`--no-vcs-ignore\` to watch files listed in \`.gitignore\` \u2014 by default, gitignored files are excluded from watch events.
+- Debounce is applied by default (300ms) \u2014 rapid file saves trigger one execution, not many.
 
 ## Why it matters for agents
 Enables live-reload dev loops \u2014 agents can set up reactive pipelines (\`watchexec -e ts "pnpm typecheck"\`) and report on each change without polling.
@@ -1069,6 +1147,9 @@ Scan filesystems, container images, and code repos for known vulnerabilities.
 - CI gate (fail on findings): \`trivy fs --severity CRITICAL,HIGH --exit-code 1 --no-progress .\`
 - Offline (skip DB update): \`trivy fs --skip-update --format json .\`
 
+## Output format
+Table to stdout by default (target, type, package, vulnerability ID, severity). \`--format json\` emits a structured CVE list with full details per vulnerability including fix version and CVSS score. \`--no-progress\` suppresses the spinner for clean CI output.
+
 ## Why it matters for agents
 Gives agents a security gate before deployments. \`--format json --exit-code 1\` creates a composable CI step \u2014 agents can parse findings and summarise critical vulnerabilities.
 
@@ -1124,6 +1205,9 @@ Send HTTP requests from the terminal. Cleaner syntax than curl, JSON-first, colo
 - Headers only: \`xh -h get api.example.com\`
 - Download file: \`xh --download get example.com/file.zip\`
 
+## Output format
+HTTP response body to stdout by default, pretty-printed and syntax-highlighted. Use \`-b\` for body only, \`-h\` for headers only. \`--print=hHbB\` controls what is shown (h=response headers, H=request headers, b=response body, B=request body). JSON bodies are pretty-printed automatically.
+
 ## Why it matters for agents
 Cleaner than curl for API testing \u2014 \`key=value\` JSON syntax removes quoting complexity. \`--check-status\` makes error handling trivial: non-zero exit on any 4xx/5xx.
 
@@ -1145,11 +1229,19 @@ Get practical, example-driven command summaries without reading full man pages.
 - Update the local cache: \`tldr --update\`
 - List all available pages: \`tldr --list\`
 - Search for a topic: \`tldr --search "compress files"\`
+- Raw output (no colour): \`tldr --raw rg\`
+
+## Output format
+Plain text formatted pages with ANSI colour codes. Use \`--raw\` or pipe through \`cat\` to strip colour. Each page is a short markdown document with a description and practical examples.
+
+## Why it matters for agents
+Faster lookup than man pages \u2014 community-maintained examples cover 90% of common usages in a scannable format. Use as the first-pass reference before falling back to \`--help\` or full man pages. \`--raw\` output is safe to include verbatim in agent context.
 
 ## Gotchas
 - First run requires internet to fetch the page cache. Run \`tldr --update\` after install.
-- Not every obscure tool has a page \u2014 fall back to \`man\` or \`--help\` when missing.
-- Pages are community-written; they cover common usage, not edge cases.
+- Pages are community-written; they cover common usage, not edge cases \u2014 missing for obscure tools.
+- \`tldr --update\` refreshes the local cache; stale caches may show outdated examples.
+- Not every tool has a page \u2014 fall back to \`man\` or \`--help\` when missing.
 `.trim();
 
 // src/skills/biome.ts
@@ -1167,6 +1259,9 @@ Fast, zero-config linter and formatter for JavaScript/TypeScript projects. Repla
 - Init config: \`biome init\`
 - Check single file: \`biome check src/index.ts\`
 
+## Output format
+Text diagnostics to stderr with file, line, rule name, and description. \`--reporter=json\` emits structured linting output with arrays of diagnostics per file \u2014 parse with \`jq\` to filter by severity or rule.
+
 ## Gotchas
 - Requires a \`biome.json\` config or \`--config-path\` flag; \`biome init\` generates a sensible default.
 - Not 100% compatible with all ESLint rules \u2014 check the migration guide when switching existing projects.
@@ -1190,10 +1285,14 @@ Compare files by syntax tree, not line-by-line. Understands code structure so re
 - Diff staged changes: \`GIT_EXTERNAL_DIFF=difft git diff --cached\`
 - Plain text mode (no syntax): \`difft --display side-by-side-show-both old.txt new.txt\`
 
+## Output format
+Side-by-side ANSI diff to stdout. Not machine-parseable \u2014 designed for human review only. Falls back to line-by-line diff for unsupported file types. Terminal width determines column widths.
+
 ## Gotchas
 - Supports most languages automatically via file extension detection.
 - Output is always side-by-side; pipe width matters \u2014 use a wide terminal.
 - Falls back to line-diff for unsupported file types.
+- Not suitable for programmatic diffing \u2014 use \`git diff --unified\` for machine-parseable output.
 
 ## Why it matters for agents
 Understands code structure \u2014 avoids false-positive diffs from formatting changes. Agents using \`GIT_EXTERNAL_DIFF=difft git diff\` get semantic change summaries, not noise.
@@ -1303,6 +1402,9 @@ gitleaks protect --staged   # pre-commit hook
 gitleaks detect             # CI full scan
 \`\`\`
 
+## Output format
+Text summary to stdout listing finding count and rule matches. \`--report-format json --report-path out.json\` writes structured findings with file, line, rule, commit, and matched secret fragment. Terminal output is human-readable only.
+
 ## Why it matters for agents
 Agents editing configuration files or adding credentials must scan before committing. Exit code 1 on findings makes it trivially composable as a pre-commit gate.
 
@@ -1403,6 +1505,9 @@ Find and fix typos in source code, comments, docs, filenames, and variable names
 - Check specific file types: \`typos --type rust src/\`
 - Ignore a word: add to \`_typos.toml\`: \`[default.extend-words]\` \u2192 \`teh = "teh"\`
 
+## Output format
+\`file:line:col: "typo" -> "correction"\` per finding to stdout. \`--format json\` emits structured output with file, line, column, typo, and correction fields \u2014 parse with \`jq\` for batch processing. Exits 1 if typos found.
+
 ## Why it matters for agents
 Agents generate a lot of code. Running typos as a final pass catches misspellings in variable names, comments, and docs that slip past linters.
 
@@ -1576,6 +1681,9 @@ Scan code for security vulnerabilities, bugs, and anti-patterns across 30+ langu
 - Scan single file: \`semgrep scan --config auto path/to/file.ts\`
 - JSON output: \`semgrep scan --config auto --json\`
 
+## Output format
+Text findings to stdout with file, line, rule ID, and matched code snippet. \`--json\` emits structured match objects with file, line range, severity, rule metadata, and matched text \u2014 pipe to \`jq\` for filtering.
+
 ## Why it matters for agents
 Agents can run security and quality scans before committing code. Much broader language coverage than shellcheck or biome alone.
 
@@ -1635,6 +1743,329 @@ Agents verifying domain setups, debugging DNS issues, or checking propagation ge
 - JSON output with \`--json\` is ideal for piping to jq.
 `.trim();
 
+// src/skills/vips.ts
+var vips_default = `
+# libvips \u2014 Fast image processing
+
+## When to use
+Batch-process images with lower memory usage and higher speed than ImageMagick. Powers the Sharp Node.js library.
+
+## Trusted commands
+- Get image info: \`vipsheader image.jpg\`
+- Resize image: \`vips resize input.jpg output.jpg 0.5\`
+- Convert format: \`vips copy input.png output.webp\`
+- Create thumbnail: \`vips thumbnail input.jpg output.jpg 300\`
+- Extract area: \`vips crop input.jpg output.jpg 0 0 100 100\`
+
+## Why it matters for agents
+Agents processing images in bulk get significantly faster throughput with lower memory overhead than ImageMagick.
+
+## Gotchas
+- Commands use \`vips\` or \`vipsthumbnail\` \u2014 check both are available.
+- Output format is inferred from the file extension.
+- Streaming pipeline architecture means memory stays flat even for large images.
+`.trim();
+
+// src/skills/resvg.ts
+var resvg_default = `
+# resvg \u2014 High-fidelity SVG renderer
+
+## When to use
+Render SVG files to PNG with accurate results. Handles complex SVGs that other tools misrender.
+
+## Trusted commands
+- Render SVG to PNG: \`resvg input.svg output.png\`
+- Set output width: \`resvg input.svg output.png -w 1024\`
+- Set output height: \`resvg input.svg output.png -h 768\`
+- Set DPI: \`resvg input.svg output.png --dpi 300\`
+
+## Why it matters for agents
+Agents generating social images, OG cards, or icons from SVG templates get pixel-perfect PNG output.
+
+## Gotchas
+- Rust-based \u2014 very fast but no interactive mode.
+- Pairs well with svgo: optimise SVG first, then render with resvg.
+- Supports most SVG features including filters and gradients.
+`.trim();
+
+// src/skills/chafa.ts
+var chafa_default = `
+# chafa \u2014 Image-to-ANSI art renderer
+
+## When to use
+Preview images directly in the terminal as coloured text art. Useful when agents need to "see" an image without a GUI.
+
+## Trusted commands
+- Preview image: \`chafa image.png\`
+- Set output size: \`chafa -s 80x24 image.png\`
+- Use specific symbols: \`chafa --symbols block image.png\`
+- ASCII-only output: \`chafa --symbols ascii image.png\`
+- Preview with transparency: \`chafa --bg white image.png\`
+
+## Why it matters for agents
+Agents can inspect image outputs without leaving the terminal \u2014 verify screenshots, check generated graphics, review thumbnails.
+
+## Gotchas
+- Quality depends on terminal capabilities. Use \`--format symbols\` for widest compatibility.
+- Works with PNG, JPEG, GIF, WebP, and many other formats.
+- Pipe support: \`curl -s url | chafa -\`
+`.trim();
+
+// src/skills/oha.ts
+var oha_default = `
+# oha \u2014 HTTP load tester
+
+## When to use
+Benchmark HTTP endpoints with concurrent requests and get structured JSON results. Complements xh (single requests) with load testing.
+
+## Trusted commands
+- Basic load test: \`oha -n 100 -c 10 http://localhost:3000\`
+- JSON output: \`oha -n 100 -c 10 --json http://localhost:3000\`
+- Set duration: \`oha -z 10s -c 50 http://localhost:3000\`
+- POST with body: \`oha -n 100 -m POST -d '{"key":"val"}' http://localhost:3000/api\`
+- Custom headers: \`oha -n 100 -H "Authorization: Bearer token" http://localhost:3000\`
+
+## Why it matters for agents
+Agents benchmarking API changes get structured latency percentiles, throughput, and error rates as JSON they can compare programmatically.
+
+## Gotchas
+- \`-n\` = number of requests, \`-c\` = concurrent connections, \`-z\` = duration.
+- JSON output with \`--json\` is ideal for piping to jq.
+- Rust-based \u2014 extremely low overhead compared to other load testers.
+`.trim();
+
+// src/skills/fx.ts
+var fx_default = `
+# fx \u2014 Interactive JSON viewer
+
+## When to use
+Explore and filter JSON data interactively. Complements jq with a visual, navigable interface.
+
+## Trusted commands
+- View JSON file: \`fx data.json\`
+- Pipe JSON: \`cat data.json | fx\`
+- Apply JS expression: \`fx data.json '.items.map(x => x.name)'\`
+- Filter with dot notation: \`fx data.json '.users[0].email'\`
+- Reduce: \`fx data.json '.items.length'\`
+
+## Why it matters for agents
+Agents exploring unfamiliar API responses or config files can quickly navigate nested structures and extract paths for jq queries.
+
+## Gotchas
+- Accepts JavaScript expressions, not jq syntax.
+- Interactive mode requires a TTY \u2014 use expressions for scripting.
+- Reads from stdin or file argument.
+`.trim();
+
+// src/skills/pastel.ts
+var pastel_default = `
+# pastel \u2014 Color manipulation tool
+
+## When to use
+Generate, convert, inspect, and manipulate colours from the terminal. Ideal for design token generation and palette work.
+
+## Trusted commands
+- Show color info: \`pastel color "#ff6b35"\`
+- Convert format: \`pastel format hsl "#ff6b35"\`
+- Generate palette: \`pastel gradient -n 5 "#ff6b35" "#1a1a2e"\`
+- Lighten colour: \`pastel lighten 0.2 "#ff6b35"\`
+- Darken colour: \`pastel darken 0.2 "#ff6b35"\`
+- Complementary: \`pastel complement "#ff6b35"\`
+- Mix colours: \`pastel mix "#ff6b35" "#1a1a2e"\`
+
+## Why it matters for agents
+Agents generating design tokens, theme files, or CSS variables can programmatically derive entire palettes from brand colours.
+
+## Gotchas
+- Supports hex, RGB, HSL, Lab, and named CSS colours.
+- Use \`pastel list\` to see all named colours.
+- Output can be piped \u2014 combine with sd for bulk colour replacement.
+`.trim();
+
+// src/skills/csview.ts
+var csview_default = `
+# csview \u2014 CSV/TSV viewer
+
+## When to use
+View tabular data (CSV, TSV) with aligned columns and optional styling in the terminal.
+
+## Trusted commands
+- View CSV: \`csview data.csv\`
+- View TSV: \`csview -t data.tsv\`
+- Custom delimiter: \`csview -d ';' data.csv\`
+- No header row: \`csview --no-headers data.csv\`
+- Pipe from stdin: \`cat data.csv | csview\`
+
+## Why it matters for agents
+Agents inspecting exported data, build reports, or log tables get clean columnar output instead of comma-separated noise.
+
+## Gotchas
+- Rust-based \u2014 handles large files efficiently.
+- Use \`-t\` flag for TSV files.
+- For SQL-level queries on CSV, use duckdb instead.
+`.trim();
+
+// src/skills/asciinema.ts
+var asciinema_default = `
+# asciinema \u2014 Terminal session recorder
+
+## When to use
+Record terminal sessions as lightweight asciicast files for documentation, demos, or bug reports.
+
+## Trusted commands
+- Record session: \`asciinema rec demo.cast\`
+- Play recording: \`asciinema play demo.cast\`
+- Record with idle limit: \`asciinema rec --idle-time-limit 2 demo.cast\`
+- Record specific command: \`asciinema rec --command "pnpm test" demo.cast\`
+- Upload to asciinema.org: \`asciinema upload demo.cast\`
+
+## Why it matters for agents
+Agents can record their terminal workflows for review, create reproducible demos, or capture test runs for debugging.
+
+## Gotchas
+- Recordings are text-based (not video) \u2014 tiny file sizes and searchable.
+- Set \`--idle-time-limit\` to trim long pauses.
+- \`.cast\` files can be embedded in web pages with the asciinema player.
+`.trim();
+
+// src/skills/d2.ts
+var d2_default = `
+# d2 \u2014 Declarative diagramming language
+
+## When to use
+Generate architecture diagrams, flowcharts, sequence diagrams, and ERDs from text. Output SVG or PNG without a GUI.
+
+## Trusted commands
+- Render to SVG: \`d2 input.d2 output.svg\`
+- Render to PNG: \`d2 input.d2 output.png\`
+- Watch mode: \`d2 --watch input.d2 output.svg\`
+- Set theme: \`d2 --theme 200 input.d2 output.svg\`
+- Set layout engine: \`d2 --layout elk input.d2 output.svg\`
+
+## Why it matters for agents
+Agents generate architecture and flow diagrams from code analysis \u2014 describe structure in text, get publication-ready SVGs.
+
+## Gotchas
+- D2 files use a simple DSL: \`a -> b: label\`.
+- Supports sequence diagrams, classes, ERDs, and grid diagrams.
+- Multiple layout engines: dagre (default), elk, tala.
+`.trim();
+
+// src/skills/pngquant.ts
+var pngquant_default = `
+# pngquant \u2014 Lossy PNG compressor
+
+## When to use
+Reduce PNG file size by 50-80% with minimal visual quality loss. Ideal for web assets, screenshots, and icons.
+
+## Trusted commands
+- Compress with default quality: \`pngquant image.png\`
+- Set quality range: \`pngquant --quality=65-80 image.png\`
+- Overwrite original: \`pngquant --force --ext .png image.png\`
+- Batch compress: \`pngquant --force --ext .png *.png\`
+- Output to stdout: \`pngquant - < input.png > output.png\`
+
+## Why it matters for agents
+Agents optimise generated screenshots, OG images, and icon sets \u2014 often cutting 60-70% off PNG sizes before deployment.
+
+## Gotchas
+- Lossy compression \u2014 visually near-identical but not bit-perfect.
+- Combine with oxipng for lossy + lossless pipeline.
+- Exit code 99 means quality target can't be met \u2014 widen the range.
+`.trim();
+
+// src/skills/oxipng.ts
+var oxipng_default = `
+# oxipng \u2014 Lossless PNG optimizer
+
+## When to use
+Reduce PNG file size without any quality loss. Run after pngquant for maximum compression, or standalone for lossless-only workflows.
+
+## Trusted commands
+- Optimize in place: \`oxipng -o 4 image.png\`
+- Max compression: \`oxipng -o max image.png\`
+- Batch optimize: \`oxipng -o 4 -r ./images/\`
+- Strip metadata: \`oxipng -o 4 --strip safe image.png\`
+- Preserve original: \`oxipng -o 4 --out optimized.png image.png\`
+
+## Why it matters for agents
+Agents run oxipng as a final pass on all PNG assets \u2014 guaranteed size reduction with zero quality loss.
+
+## Gotchas
+- \`-o\` levels: 0 (fast) to max (slow). Level 4 is a good default.
+- \`--strip safe\` removes metadata without breaking rendering.
+- Rust-based \u2014 fast even on large batches.
+`.trim();
+
+// src/skills/gron.ts
+var gron_default = `
+# gron \u2014 Flatten JSON for grepping
+
+## When to use
+Turn nested JSON into greppable assignment statements. Find paths in complex API responses without writing jq expressions.
+
+## Trusted commands
+- Flatten JSON: \`gron data.json\`
+- Flatten from URL: \`gron https://api.example.com/data\`
+- Pipe from stdin: \`cat data.json | gron\`
+- Grep for field: \`gron data.json | grep "name"\`
+- Unflatten back to JSON: \`gron data.json | grep "users" | gron --ungron\`
+
+## Why it matters for agents
+Agents exploring unfamiliar JSON APIs can grep for field names across deeply nested structures, then reconstruct filtered subsets.
+
+## Gotchas
+- Output format: \`json.users[0].name = "Alice";\` \u2014 each line is a full path.
+- \`--ungron\` converts flattened output back to valid JSON.
+- Combine with rg for regex filtering of JSON paths.
+`.trim();
+
+// src/skills/lychee.ts
+var lychee_default = `
+# lychee \u2014 Fast link checker
+
+## When to use
+Scan documentation, markdown files, and websites for broken links. Catches dead URLs, redirects, and timeouts.
+
+## Trusted commands
+- Check markdown files: \`lychee "**/*.md"\`
+- Check a URL: \`lychee https://example.com\`
+- Check with config: \`lychee --config lychee.toml "**/*.md"\`
+- JSON output: \`lychee --format json "**/*.md"\`
+- Exclude patterns: \`lychee --exclude "localhost" "**/*.md"\`
+
+## Why it matters for agents
+Agents validate documentation links after edits \u2014 catch broken references before they ship to production.
+
+## Gotchas
+- Rust-based \u2014 extremely fast, checks links concurrently.
+- Use \`.lycheeignore\` or \`--exclude\` for known-flaky URLs.
+- Supports markdown, HTML, and plain text files.
+`.trim();
+
+// src/skills/vale.ts
+var vale_default = `
+# vale \u2014 Prose linter for documentation
+
+## When to use
+Enforce writing style guides on documentation, README files, and technical content. Catches jargon, passive voice, and style violations.
+
+## Trusted commands
+- Lint a file: \`vale README.md\`
+- Lint a directory: \`vale docs/\`
+- JSON output: \`vale --output JSON README.md\`
+- Initialize config: \`vale sync\`
+- List installed styles: \`vale ls-config\`
+
+## Why it matters for agents
+Agents writing or editing documentation can validate prose quality against style guides \u2014 Google, Microsoft, or custom rules.
+
+## Gotchas
+- Requires a \`.vale.ini\` config file in the project root.
+- Install styles with \`vale sync\` after configuring packages.
+- Common styles: Google, Microsoft, write-good, proselint.
+`.trim();
+
 // src/skills.ts
 var SKILL_CONTENT = {
   rg: rg_default,
@@ -1686,7 +2117,21 @@ var SKILL_CONTENT = {
   taplo: taplo_default,
   semgrep: semgrep_default,
   age: age_default,
-  doggo: doggo_default
+  doggo: doggo_default,
+  vips: vips_default,
+  resvg: resvg_default,
+  chafa: chafa_default,
+  oha: oha_default,
+  fx: fx_default,
+  pastel: pastel_default,
+  csview: csview_default,
+  asciinema: asciinema_default,
+  d2: d2_default,
+  pngquant: pngquant_default,
+  oxipng: oxipng_default,
+  gron: gron_default,
+  lychee: lychee_default,
+  vale: vale_default
 };
 function skillFilename(toolId) {
   return `${toolId}.md`;
@@ -1912,7 +2357,7 @@ program.command("verify").alias("doctor").description("Check which tools are ins
 });
 program.command("list").description("Print the tool catalog").option("--json", "Output as JSON").option("--brewfile", "Output macOS Brewfile (darwin only)").action(async (opts) => {
   if (opts.brewfile) {
-    const { generateBrewfileFromCatalog } = await import("./catalog-PTLCQEDW.js");
+    const { generateBrewfileFromCatalog } = await import("./catalog-7NB7RALT.js");
     console.log(generateBrewfileFromCatalog());
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loadout",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "One command to load out your terminal for agentic coding",
   "type": "module",
   "bin": {
@@ -25,8 +25,16 @@
     "developer-tools",
     "loadout"
   ],
-  "author": "",
+  "author": "cluddy",
   "license": "MIT",
+  "homepage": "https://github.com/conorluddy/agent-loadout#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/conorluddy/agent-loadout.git"
+  },
+  "bugs": {
+    "url": "https://github.com/conorluddy/agent-loadout/issues"
+  },
   "dependencies": {
     "@inquirer/prompts": "^8.3.0",
     "chalk": "^5.4.0",