@atollhq/skill-gemini 0.4.0 → 0.4.1

package/package.json

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

package/skill/SKILL.md

@@ -163,6 +163,76 @@ CLI JSON conventions:
 - `atoll agent-context` returns a versioned command/flag manifest and available profile context.
 - `atoll plan validate/apply` consumes `schemaVersion: "atoll.plan.v1"` files with `milestones`, `issues`, `dependencies`, `initiativeLinks`, and `milestoneLinks`; local `key` values can be referenced by `milestoneKey`, `issueKey`, `dependsOn`, `blockedBy`, or `blocks`.
 
+## AI-Assisted Setup
+
+When a user needs help setting up Atoll, lean into the AI workflow. Atoll is most useful when the user's AI assistant helps turn messy context into projects, issues, goals, KPIs, and agent instructions.
+
+If you are the AI assistant with CLI access, prefer doing the setup directly after confirming the intended org/profile and scope. Start with read-only orientation:
+
+```bash
+atoll auth profiles
+atoll heartbeat --json
+atoll issue list --json --limit 10
+```
+
+If the user is setting up Atoll in another AI tool, give them a copyable prompt. Keep secrets out of chat: tell the user to run auth commands locally and never ask them to paste `sk_atoll_...` keys into a model conversation unless they explicitly choose that risk.
+
+### Prompt: Create the First Board
+
+```text
+I am setting up Atoll for my team. Help me create the first project an AI agent could understand.
+Ask me 3-5 questions about the current push, then propose:
+- one project name
+- the outcome this project should drive
+- 3-5 initial issues with clear titles, context, priorities, and owners if known
+- which issue an agent should pick up first and why
+Keep the setup small. I want a useful first board, not a full migration.
+```
+
+### Prompt: Turn a Project Into Issues
+
+```text
+I have an Atoll project but need help turning it into actionable issues.
+Interview me about the project, then write 5 issues an AI agent could execute.
+For each issue include:
+- title
+- why it matters
+- acceptance criteria
+- suggested priority
+- any context the agent would need before starting
+Make the issues specific enough that I can paste them into Atoll with minimal editing.
+```
+
+### Prompt: Install and Authenticate the CLI
+
+```text
+Help me connect this workspace to Atoll.
+First, explain what the Atoll CLI will let you do and what credentials you need.
+Then walk me through installing @atollhq/cli, adding an agent in Atoll, authenticating with the API key, and running a safe read-only check like `atoll issue list`.
+Do not ask me to paste secrets into chat unless I explicitly choose to. Tell me where to run each command locally.
+```
+
+### Prompt: Run the First Heartbeat
+
+```text
+You are helping me set up Atoll for agentic project management.
+Use the Atoll CLI to orient before doing any work.
+Run `atoll heartbeat`, summarize what you can see, identify the highest-leverage next action, and tell me whether you have enough access to list issues and update your assigned work.
+If anything is missing, explain the exact setup step I need to complete in Atoll.
+```
+
+### Prompt: Draft the Strategy Chain
+
+```text
+Help me define the strategy chain for my Atoll workspace.
+Ask me what business outcome matters most this month, then propose:
+- one goal with a clear target date
+- 1-2 KPIs that show whether we are on pace
+- one initiative expected to move the KPI
+- 3 issues that belong under that initiative
+Keep it practical. I want the smallest strategy layer that would help an AI agent choose better work.
+```
+
 ## Quick Start — API (for advanced use)
 
 All CLI commands map to REST endpoints. Use the API directly when the CLI doesn't cover a specific operation.