docs(readme): add -g (global) flag to every npx skills example

`npx skills add` defaults to project-local install (`./.skills/`,
committed with the repo). For a research-the-world skill like this one,
that's almost never what users want — they want it available across all
projects, not scoped to whichever directory they happened to run the
install from.

Adding `-g` (global) to every npx skills example in the README:
- Top-of-file install snippet
- Install table row
- Claude Code subsection's "alternative via npx skills" example
- Codex/Cursor/etc. subsection's default, per-harness, update, list,
  and remove commands

Brief one-liner explains what `-g` does and notes that dropping it
gives a project-local install for users who want team consistency on
a specific codebase.
This commit is contained in:
Trevin Chow
2026-05-15 23:20:33 -07:00
parent ded52062e6
commit d1cc29d338
+16 -13
View File
@@ -21,8 +21,9 @@ This README tracks the current v3 pipeline. The runtime skill spec lives in [SKI
**Codex, Cursor, Copilot, Gemini CLI, or any of 50+ [Agent Skills](https://agentskills.io) hosts:** **Codex, Cursor, Copilot, Gemini CLI, or any of 50+ [Agent Skills](https://agentskills.io) hosts:**
``` ```
npx skills add mvanhorn/last30days-skill npx skills add mvanhorn/last30days-skill -g
``` ```
(`-g` installs globally for your user, available across all projects. Drop it to scope per-project.)
More install options (claude.ai web, OpenClaw, manual) in the [Install](#install) section below. More install options (claude.ai web, OpenClaw, manual) in the [Install](#install) section below.
@@ -167,7 +168,7 @@ Say "eli5 on" after any research run. The synthesis rewrites in plain language.
| Surface | Install | Updates | | Surface | Install | Updates |
|---------|---------|---------| |---------|---------|---------|
| **Claude Code** (recommended) | `/plugin marketplace add mvanhorn/last30days-skill` | Auto via marketplace, or `claude plugin update last30days@last30days-skill` | | **Claude Code** (recommended) | `/plugin marketplace add mvanhorn/last30days-skill` | Auto via marketplace, or `claude plugin update last30days@last30days-skill` |
| **Codex, Cursor, Copilot, Gemini CLI, GitHub Copilot, or any of 50+ [Agent Skills](https://agentskills.io) hosts** | `npx skills add mvanhorn/last30days-skill` | `npx skills update last30days` | | **Codex, Cursor, Copilot, Gemini CLI, GitHub Copilot, or any of 50+ [Agent Skills](https://agentskills.io) hosts** | `npx skills add mvanhorn/last30days-skill -g` | `npx skills update last30days -g` |
| **claude.ai** (web) | [Download `last30days.skill`](https://github.com/mvanhorn/last30days-skill/releases/latest/download/last30days.skill) and upload via Settings > Capabilities > Skills > + | Re-download and re-upload | | **claude.ai** (web) | [Download `last30days.skill`](https://github.com/mvanhorn/last30days-skill/releases/latest/download/last30days.skill) and upload via Settings > Capabilities > Skills > + | Re-download and re-upload |
| **OpenClaw** | `clawhub install last30days-official` | `clawhub update last30days-official` | | **OpenClaw** | `clawhub install last30days-official` | `clawhub update last30days-official` |
@@ -182,7 +183,7 @@ Recommended because the Claude Code marketplace handles updates for you — the
If you'd rather use the agent-skills install path on Claude Code, that's also supported: If you'd rather use the agent-skills install path on Claude Code, that's also supported:
``` ```
npx skills add mvanhorn/last30days-skill -a claude-code npx skills add mvanhorn/last30days-skill -g -a claude-code
``` ```
The native plugin and the `npx skills` install can coexist; Claude Code dedupes the slash command. The native plugin and the `npx skills` install can coexist; Claude Code dedupes the slash command.
@@ -192,31 +193,33 @@ The native plugin and the `npx skills` install can coexist; Claude Code dedupes
Install via the open [Agent Skills](https://agentskills.io) CLI — supports 50+ harnesses including `codex`, `cursor`, `github-copilot`, `gemini-cli`, `claude-code`, `windsurf`, `cline`, `continue`, `roo`, `aider-desk`, `opencode`, `goose`, and more (full list on the [vercel-labs/skills repo](https://github.com/vercel-labs/skills)). Install via the open [Agent Skills](https://agentskills.io) CLI — supports 50+ harnesses including `codex`, `cursor`, `github-copilot`, `gemini-cli`, `claude-code`, `windsurf`, `cline`, `continue`, `roo`, `aider-desk`, `opencode`, `goose`, and more (full list on the [vercel-labs/skills repo](https://github.com/vercel-labs/skills)).
```bash ```bash
npx skills add mvanhorn/last30days-skill npx skills add mvanhorn/last30days-skill -g
``` ```
By default this installs for whichever harness it detects. To target a specific one (or multiple): The `-g` (global) flag installs to your user directory so the skill is available across all projects. Without `-g`, `npx skills` installs project-locally into `./.skills/` (committed with the repo). For a research-the-world tool, global is what you want.
By default this installs for whichever harness `npx skills` detects. To target a specific one (or multiple):
```bash ```bash
npx skills add mvanhorn/last30days-skill -a codex npx skills add mvanhorn/last30days-skill -g -a codex
npx skills add mvanhorn/last30days-skill -a cursor npx skills add mvanhorn/last30days-skill -g -a cursor
npx skills add mvanhorn/last30days-skill -a gemini-cli npx skills add mvanhorn/last30days-skill -g -a gemini-cli
npx skills add mvanhorn/last30days-skill -a codex -a cursor npx skills add mvanhorn/last30days-skill -g -a codex -a cursor
``` ```
Update later with: Update later with:
```bash ```bash
npx skills update last30days npx skills update last30days -g
``` ```
Or update everything you've installed via `npx skills`: Or update everything you've installed globally via `npx skills`:
```bash ```bash
npx skills update npx skills update -g
``` ```
List and remove with `npx skills list` and `npx skills remove last30days`. List and remove with `npx skills list -g` and `npx skills remove last30days -g`.
### claude.ai (web) ### claude.ai (web)