@atollhq/skill-gemini 0.2.2 → 0.3.1

package/README.md

@@ -43,7 +43,7 @@ For terminal-first work, see [`@atollhq/cli`](https://www.npmjs.com/package/@ato
 
 ```bash
 npm install -g @atollhq/cli
-atoll auth login --profile agent-a --key sk_atoll_... --org your-org-slug --project project-id --team team-id
+atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid --project project-id --team team-id
 atoll heartbeat
 atoll issue list --json
 atoll agent-context
@@ -52,11 +52,13 @@ atoll agent-context
 For multiple agents or orgs, use CLI auth profiles:
 
 ```bash
-atoll auth login --profile agent-a --key sk_atoll_... --org acme
-atoll auth login --profile agent-b --key sk_atoll_... --org client --project project-id --team team-id
+atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid
+atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --project project-id --team team-id
 atoll --profile agent-b issue list
 ```
 
+Always persist `--org-id` on named profiles, or pass `--org-id` per command. Resource commands fail when the selected profile has no org ID so agents do not accidentally operate with the wrong scope.
+
 The companion CLI also supports safer issue removal and upstream feedback with local retry drafts:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-gemini",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Install the Atoll project management integration for Gemini CLI",
   "bin": {
     "skill-gemini": "bin/install.mjs"

package/skill/SKILL.md

@@ -57,14 +57,14 @@ Configure once:
 
 ```bash
 atoll auth login --key sk_atoll_...
-atoll config set-org my-org
+atoll config set-org org-uuid
 ```
 
 For machines or agents that need multiple credentials, use auth profiles:
 
 ```bash
-atoll auth login --profile agent-a --key sk_atoll_... --org acme
-atoll auth login --profile agent-b --key sk_atoll_... --org client --project project-id --team team-id
+atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid
+atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --project project-id --team team-id
 atoll auth profiles
 atoll auth use agent-a
 
@@ -72,7 +72,9 @@ atoll auth use agent-a
 atoll --profile agent-b issue list
 ```
 
-Profiles can store default project, team, and base URL values. `atoll issue list` and `atoll issue create` apply the selected default team unless a command-level `--team` override is passed.
+Profiles can store default org ID, project, team, and base URL values. For named profiles, always persist `--org-id` or pass `--org-id` per command. Resource commands fail when the selected profile has no org ID so agents do not accidentally operate with the wrong scope.
+
+`atoll issue list` and `atoll issue create` apply the selected default team unless a command-level `--team` override is passed.
 
 Common commands:
 

package/skill/references/api-fields.md

@@ -129,7 +129,7 @@ Recording a snapshot auto-updates the KPI's `current_value`.
 For portfolio-style initiatives (grouping projects):
 ```json
 {
-  "name": "Q2 Platform Rewrite",
+  "title": "Q2 Platform Rewrite",
   "description": "Migrate all services to new architecture",
   "owner_id": "member-uuid",
   "start_date": "2026-04-01",
@@ -137,6 +137,8 @@ For portfolio-style initiatives (grouping projects):
 }
 ```
 
+Use `title` for create/update requests; Atoll keeps the legacy `name` field in sync for compatibility.
+
 Add/remove projects with `{ "project_id": "uuid" }`.
 
 ## Automation Rule Fields