Use the public toolbox scripts published from docs/tools via tool-runner.js. Covers listing tools, executing them safely with droid exec context, and required environment variables.
Content & Writing
142 Stars
27 Forks
Updated Jan 19, 2026, 04:33 AM
Why Use This
This skill provides specialized capabilities for factory-ben's codebase.
Use Cases
Developing new features in the factory-ben repository
Refactoring existing code to follow factory-ben standards
Understanding and working with factory-ben's codebase structure
---
name: site-tools
description: Use the public toolbox scripts published from docs/tools via tool-runner.js. Covers listing tools, executing them safely with droid exec context, and required environment variables.
---
# 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
1. **List tools**
```bash
node docs/tools/tool-runner.js --list
```
2. **Run a tool locally** (prefers local script, falls back to public copy):
```bash
node docs/tools/tool-runner.js <tool-name> --flag value
```
Example (dry run):
```bash
FACTORY_API_KEY=*** \
node docs/tools/tool-runner.js classify-feed --input docs/data/feed.json --dry-run
```
3. **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.
4. **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
