Site Toolbox Skill

Capability

Operate the public toolbox that ships with this repo. Each tool lives under docs/tools/<tool>/script.js and is mirrored to GitHub Pages (default base URL https://factory-ben.github.io/feed-aggregator). Use tool-runner.js to list, download (if needed), and execute tools so every automation step stays lightweight and reproducible.

How to use

List tools
```
node docs/tools/tool-runner.js --list
```

Run a tool locally (prefers local script, falls back to public copy):

node docs/tools/tool-runner.js <tool-name> --flag value

Example (dry run):

FACTORY_API_KEY=*** \
node docs/tools/tool-runner.js classify-feed --input docs/data/feed.json --dry-run

Environment: export FACTORY_API_KEY (Factory CLI auth), optional MODEL_ID=glm-4.6, MODEL_REASONING=low, CLASSIFIER_MAX_BATCH=10. Legacy GLM_* vars are still read but will be removed once all workflows migrate.
Autonomy & safety: prefer droid exec read-only flows; only enable higher autonomy or repo mutations if the tool explicitly states so. Inspect scripts under docs/tools/ before running remote copies.

Verification

After running toolbox commands that mutate repo files, run npm run build:tools (keeps manifest fresh) and any relevant validation commands noted by the tool. For the classifier, rerun with --dry-run to confirm GLM responses before writing.
All artifacts land in docs/data/ unless overridden. Commit outputs only after reviewing diffs.

When to reach for this skill

Need to classify feed entries, export stats, or run future automation hosted as simple scripts without inflating the app server.
Want a reproducible workflow that GitHub Actions can mirror (install Factory CLI, call tool-runner, push results).

References

Skills format: https://docs.factory.ai/cli/configuration/skills
droid exec usage: https://docs.factory.ai/cli/droid-exec/overview.md