@atollhq/skill-claude 0.4.11 → 0.4.13

package/README.md

@@ -18,11 +18,11 @@ Get an agent API key from **Agents** in the Atoll app. Integration keys are stil
 
 This does three things:
 
-1. Copies the skill into `~/.claude/skills/atoll-api/`
+1. Copies the skill into `~/.claude/skills/atoll/`
 2. Removes stale Atoll credential/profile env from `~/.claude/settings.json` when profile mode is used
 3. Creates or updates the named Atoll CLI profile when `--profile` is provided
 
-Restart Claude Code and the `atoll-api` skill is available.
+Restart Claude Code and the `atoll` skill is available.
 
 Use `@latest` in the `npx` command so npm does not reuse a stale cached installer. In profile mode, the installer prints its package version and a verification command; run `atoll --profile agent-a agent-context --json` if you need to confirm the profile was created.
 

package/bin/install.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, rmSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
@@ -121,13 +121,18 @@ function writeAtollProfile() {
   console.log(`Configured Atoll CLI profile "${args.profile}" in ${configPath}`)
 }
 
-// 1. Copy skill files to ~/.claude/skills/atoll-api/
+// 1. Copy skill files to ~/.claude/skills/atoll/
 const skillSrc = join(__dirname, '..', 'skill')
-const skillDest = join(homedir(), '.claude', 'skills', 'atoll-api')
+const skillDest = join(homedir(), '.claude', 'skills', 'atoll')
+const legacySkillDest = join(homedir(), '.claude', 'skills', 'atoll-api')
 
 mkdirSync(join(skillDest, 'references'), { recursive: true })
 cpSync(skillSrc, skillDest, { recursive: true })
 console.log(`Installed skill to ${skillDest}`)
+if (existsSync(legacySkillDest)) {
+  rmSync(legacySkillDest, { recursive: true, force: true })
+  console.log(`Removed legacy Atoll skill at ${legacySkillDest}`)
+}
 
 // 2. Configure ~/.claude/settings.json. Profile mode stores credentials only
 // in the Atoll CLI profile and removes stale credential/profile env from
@@ -176,5 +181,5 @@ if (args.profile) {
   console.log(`Verify the profile with: atoll --profile ${args.profile} agent-context --json`)
 }
 
-console.log(`\nDone! Start Claude Code and the atoll-api skill will be available.`)
+console.log(`\nDone! Start Claude Code and the atoll skill will be available.`)
 console.log(`Try: "List my Atoll tasks" or "Check my heartbeat"`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-claude",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Install the Atoll project management skill for Claude Code",
   "bin": {
     "skill-claude": "bin/install.mjs"

package/skill/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: atoll-api
-description: Interact with the Atoll project management API for managing tasks, projects, goals, KPIs, initiatives, milestones, comments, members, teams, labels, dependencies, automation, and webhooks. Use when making HTTP requests to atollhq.com, working with Atoll issues/tasks, creating or updating projects, managing team workflows, tracking goals and KPIs, or building agent integrations with the Atoll platform. Atoll treats agents as equal team members — not assistants — with their own goals, assigned work, and the ability to self-direct based on business context.
+name: atoll
+description: Interact with Atoll project management through CLI, API, and MCP guidance for tasks, projects, goals, KPIs, initiatives, milestones, comments, members, teams, labels, dependencies, automation, and webhooks. Use when working with Atoll issues/tasks, creating or updating projects, managing team workflows, tracking goals and KPIs, making HTTP requests to atollhq.com, or building agent integrations with the Atoll platform. Atoll treats agents as equal team members — not assistants — with their own goals, assigned work, and the ability to self-direct based on business context.
 ---
 
-# Atoll API
+# Atoll
 
 Base URL: `https://atollhq.com`
 
@@ -39,7 +39,7 @@ For OpenClaw / ClawHub, prefer skill-scoped config in `~/.openclaw/openclaw.json
 {
   skills: {
     entries: {
-      "atoll-api": {
+      "atoll": {
         enabled: true,
         apiKey: "sk_atoll_...",
         env: {
@@ -111,6 +111,7 @@ atoll agent-context
 # List tasks
 atoll issue list --json
 atoll issue list --status todo --priority 1 --limit 25
+atoll issue list --scope blocked --initiative initiative-uuid --order-by due_date --order-dir asc
 
 # View a task
 atoll issue get ATOLL-42
@@ -118,6 +119,7 @@ atoll issue view ATOLL-42   # alias kept for humans
 
 # Create a task
 atoll issue create --title "Fix login bug" --status todo --priority 1
+atoll issue create --title "Weekly status review" --due-date 2026-07-06 --recurrence weekly
 atoll issue upsert --match-title --project <project-id> --title "Fix login bug" --status todo
 atoll issue bulk-create --file ./issues.json --continue-on-error
 
@@ -134,6 +136,17 @@ atoll issue assign ATOLL-42 --to self
 # Comments
 atoll comment add ATOLL-42 --body "Working on this now"
 
+# Labels, notifications, subtasks, activity
+atoll label list
+atoll label add ATOLL-42 bug
+atoll notification list --json
+atoll notification ack notification-uuid
+atoll subtask create ATOLL-42 --title "Verify recurrence"
+atoll activity issue ATOLL-42
+
+# Read-only API fallback for uncommon inspection gaps
+atoll api get /api/orgs/$ATOLL_ORG_ID/labels --json
+
 # Dependencies
 atoll dependency bulk-add --file ./dependencies.json --continue-on-error
 
@@ -188,7 +201,7 @@ CLI JSON conventions:
 
 ## KPI HTTP Sync Drafts
 
-When a human asks you to help automate a KPI from a third-party API, use this Atoll skill. If the current agent environment does not have the `atoll-api` skill installed, tell the user to install it before continuing or use the Atoll CLI/MCP tools directly if they are available.
+When a human asks you to help automate a KPI from a third-party API, use this Atoll skill. If the current agent environment does not have the `atoll` skill installed, tell the user to install it before continuing or use the Atoll CLI/MCP tools directly if they are available.
 
 Agents may create draft syncs and validate proposed configs only after a human admin has allowlisted the exact destination host in Atoll. Human admins must create or review the draft in Settings > Integrations > KPI syncs, edit supported request/extraction fields and secrets through structured UI, dry-run, publish, disable, or run-now with snapshot writing.
 
@@ -296,7 +309,11 @@ Keep it practical. I want the smallest strategy layer that would help an AI agen
 
 ## 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.
+All CLI commands map to REST endpoints. Use `atoll api get` for GET-only inspection gaps when a typed command does not exist yet. The CLI blocks `/api/internal/*`, billing, and KPI sync admin routes because some GET endpoints can run jobs, synchronize external state, or require human-admin review. Use direct API calls for writes only when the CLI does not cover a specific operation and the workflow is not human-admin-gated.
+
+```bash
+atoll api get "/api/orgs/$ATOLL_ORG_ID/issues?status=todo" --json
+```
 
 ```bash
 # Prereq: both env vars exported (see Authentication above)

package/skill/references/api-fields.md

@@ -43,7 +43,7 @@ Request bodies accept **camelCase** (`assigneeId`, `projectId`). Snake_case also
 }
 ```
 
-All fields work on both POST (create) and PATCH (update).
+Most fields work on both POST (create) and PATCH (update). `labelIds` is accepted on task create and bulk create. For existing tasks, use the label endpoints or `atoll label add/remove`.
 
 - **Multiple assignees**: Use `assigneeIds` (array). Legacy `assigneeId` (single) still works. Responses include `assignees` array with `id`, `display_name`, `type`, `avatar_url`.
 - **Start date**: Sets when work begins. Combined with `dueDate`, defines the Gantt time span.