@withone/cli 2.3.2 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -498,6 +498,28 @@ one relay deliveries --endpoint-id <id> # Check delivery status
498
498
 
499
499
  Start with `one relay platforms` to discover which platforms support relay at all, then drill into `event-types <platform>` for the specific events. Run `one guide relay` for the full reference including `--metadata` requirements per platform.
500
500
 
501
+ ### `one skills`
502
+
503
+ Optional skills for your coding agent, installed on request. The One skill itself still comes from `one init` (and `one config skills sync|status`); these commands never touch it.
504
+
505
+ ```bash
506
+ one skills list # the One skill and each optional skill, with where it is installed
507
+ one skills add connect # the One Connect skill, into this project
508
+ one skills add connect --global # ...or for every project on this machine
509
+ one skills add connect --agents claude-code,windsurf # link exactly these agents
510
+ one skills update [connect] # re-copy after upgrading @withone/connect
511
+ one skills remove connect # remove it and the agent folders that point at it
512
+ ```
513
+
514
+ What `one skills add connect` does:
515
+
516
+ 1. **Finds the skill** in the `@withone/connect` package your project installed (`node_modules/@withone/connect/skills/one-connect`), so your agent reads the docs for the exact SDK version your code calls. If the package isn't installed yet, it downloads the latest published package from npm and checks it against the registry's integrity hash first.
517
+ 2. **Installs it** into `.agents/skills/one-connect` (read by Codex, Cursor, Amp and OpenCode) and links `.claude/skills/one-connect` for Claude Code. Windsurf, Kiro, Goose and Roo get a link when the project already has their folder (`.windsurf`, `.kiro`, `.goose`, `.roo`). Where links aren't allowed (Windows without developer mode), it uses a junction, then a copy.
518
+ 3. **Stamps** the install with the package version in `.one-skill.json`.
519
+ 4. **Keeps it fresh**: any `one` command run in the project re-copies the skill when the installed `@withone/connect` version changes. Local files only; no network.
520
+
521
+ Commit `.agents/skills/one-connect` and the agent links so your team's agents share the skill. Agent mode (`--agent`) returns JSON for every subcommand.
522
+
501
523
  ### `one guide [topic]`
502
524
 
503
525
  Get the full CLI usage guide, designed for AI agents that only have the binary (no MCP, no IDE skills).