From d48c2171a65ed832c97915e47654b169d7789a23 Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Sat, 28 Mar 2026 23:01:31 -0700 Subject: [PATCH] docs: Factory Droid install instructions + CI freshness check - README: add Factory Droid section with install instructions and restart note (Factory requires restart to rescan skills) - CI: add Factory skill doc freshness verification to skill-docs.yml Co-Authored-By: Claude Opus 4.6 (1M context) --- .github/workflows/skill-docs.yml | 8 ++++++++ README.md | 13 ++++++++++++- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/.github/workflows/skill-docs.yml b/.github/workflows/skill-docs.yml index e2226037..34ea7f8e 100644 --- a/.github/workflows/skill-docs.yml +++ b/.github/workflows/skill-docs.yml @@ -23,3 +23,11 @@ jobs: echo "Generated Codex SKILL.md files are stale. Run: bun run gen:skill-docs --host codex" exit 1 } + - name: Generate Factory skill docs + run: bun run gen:skill-docs --host factory + - name: Verify Factory skill docs are fresh + run: | + git diff --exit-code -- .factory/ || { + echo "Generated Factory SKILL.md files are stale. Run: bun run gen:skill-docs --host factory" + exit 1 + } diff --git a/README.md b/README.md index 9ede0450..de015e14 100644 --- a/README.md +++ b/README.md @@ -90,7 +90,18 @@ git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gst cd ~/gstack && ./setup --host auto ``` -For Codex-compatible hosts, setup now supports both repo-local installs from `.agents/skills/gstack` and user-global installs from `~/.codex/skills/gstack`. All 28 skills work across all supported agents. Hook-based safety skills (careful, freeze, guard) use inline safety advisory prose on non-Claude hosts. +For Codex-compatible hosts, setup now supports both repo-local installs from `.agents/skills/gstack` and user-global installs from `~/.codex/skills/gstack`. All 29 skills work across all supported agents. Hook-based safety skills (careful, freeze, guard) use inline safety advisory prose on non-Claude hosts. + +### Factory Droid + +gstack works with [Factory Droid](https://factory.ai). Skills install to `.factory/skills/` and are discovered automatically. Sensitive skills (ship, land-and-deploy, guard) use `disable-model-invocation: true` so Droids don't auto-invoke them. + +```bash +git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack +cd ~/gstack && ./setup --host factory +``` + +Skills install to `~/.factory/skills/gstack-*/`. Restart `droid` to rescan skills, then type `/qa` to get started. ## See it work