@groupby/ai-dev 0.5.20 → 0.5.22

package/README.md

@@ -44,6 +44,18 @@ npx @groupby/ai-dev list teams      # List teams and content counts
 npx @groupby/ai-dev install skill <skill-name>
 ```
 
+### Update installed content
+
+Rerun the same install command after a new package version publishes. The
+installer is additive and idempotent: it skips unchanged files, prompts on
+conflicts, and honors `--force` or `--skip-existing` for non-interactive
+updates. Use `--dry-run` to preview first.
+
+```sh
+npx @groupby/ai-dev install team <team-name> --dry-run
+npx @groupby/ai-dev install team <team-name> --force
+```
+
 ### Install all team content
 
 ```sh
@@ -58,6 +70,23 @@ Installing a specific team or toolset skill also installs resources from that
 skill's owning team or toolset. You will also be prompted to optionally include
 skills from the shared library.
 
+### Third-party skills
+
+Third-party skills are external skills vendored into a team's folder, each
+carrying a `skill-meta.yml` provenance sidecar and an evaluation status. They are
+gated by that status:
+
+- `recommended` skills install (and update) automatically on every team install.
+- `evaluating` skills are held back; opt in with `--include-evaluating`.
+- `deprecated` skills are held back; opt in with `--include-deprecated`.
+
+In `list` output these skills show a status marker, for example
+`grilling [evaluating] mattpocock/skills@6654f6b`.
+
+```sh
+npx @groupby/ai-dev install team <team-name> --include-evaluating
+```
+
 ### Options
 
 | Flag | Description |
@@ -67,6 +96,10 @@ skills from the shared library.
 | `--dry-run` | Preview what would be installed without writing files |
 | `--force` | Overwrite existing files without prompting |
 | `--skip-existing` | Skip files that already exist |
+| `--clients <list>` | Write client stubs non-interactively: `copilot`, `claude`, `codex` (comma-separated), or `all` |
+| `--include-library` | Include shared library skills without prompting (use with `--clients`) |
+| `--include-evaluating` | Also install third-party skills with `evaluating` status |
+| `--include-deprecated` | Also install third-party skills with `deprecated` status |
 
 `--ai-dir` is resolved relative to `--target` and is intentionally flexible.
 Parent-directory segments such as `../shared-ai` are supported so teams can keep
@@ -76,6 +109,29 @@ Direct `install` subcommands use these options instead of prompting for a
 location. Interactive mode (`npx @groupby/ai-dev`) prompts for the AI content
 directory before showing the final install summary.
 
+### Non-interactive (one-shot) installs
+
+By default the installer prompts for which client stubs to write (and, for team
+installs, whether to include library skills). Pass `--clients` to skip those
+prompts and target clients explicitly, regardless of which are detected in the
+project:
+
+```sh
+# Install a team for all three clients with no prompts
+npx @groupby/ai-dev install team <team-name> --clients all
+
+# Pick specific clients, and include library skills too
+npx @groupby/ai-dev install team <team-name> --clients copilot,claude --include-library
+```
+
+`--clients` accepts `all` or a comma-separated list of `copilot`, `claude`, and
+`codex` (case-insensitive). At least one client is required. Combine with
+`--force` or `--skip-existing` for a fully unattended update.
+
+Without `--clients`, a non-interactive terminal (piped, CI, or an agent shell)
+cannot show the client picker, so the installer falls back to the clients it
+detects in the target project and prints a notice. Pass `--clients` to override.
+
 ## How it works
 
 1. **Discovery** — The CLI scans bundled `skills/`, `teams/`, and `toolsets/` directories for `SKILL.md` files, team prompts, team resources, and other team content folders.