@atollhq/skill-codex 0.4.11 → 0.4.13

package/README.md

@@ -27,7 +27,7 @@ Get an agent API key from **Agents** in the Atoll app. Integration keys are stil
 
 This does six things:
 
-1. Installs the `atoll-api` skill to `~/.codex/skills/atoll-api/`
+1. Installs the `atoll` skill to `~/.codex/skills/atoll/`
 2. Appends (or updates) a neutral `# Atoll Integration` section in `~/.codex/AGENTS.md`
 3. Copies API reference files to `~/.codex/atoll-references/`
 4. Creates or updates the named Atoll CLI profile when `--profile` is provided

package/bin/install.mjs

@@ -55,7 +55,7 @@ Options:
   --help      Show this help message
 
 Installs the Atoll integration for Codex CLI:
-  - Installs the atoll-api skill to ~/.codex/skills/atoll-api/
+  - Installs the atoll skill to ~/.codex/skills/atoll/
   - Writes neutral AGENTS.md API guidance to ~/.codex/
   - Creates/updates an Atoll CLI profile when --profile is provided
   - Optionally writes repo-local AGENTS.md/CLAUDE.md profile guidance with --write-project-instructions
@@ -251,15 +251,20 @@ function writeProjectInstructions() {
   writeProjectInstructionUpdates(updates)
 }
 
-// 1. Install the Codex skill to ~/.codex/skills/atoll-api/
+// 1. Install the Codex skill to ~/.codex/skills/atoll/
 const codexDir = join(homedir(), '.codex')
 mkdirSync(codexDir, { recursive: true })
 
 const skillDir = join(__dirname, '..', 'skill')
-const skillDest = join(codexDir, 'skills', 'atoll-api')
+const skillDest = join(codexDir, 'skills', 'atoll')
+const legacySkillDest = join(codexDir, 'skills', 'atoll-api')
 mkdirSync(skillDest, { recursive: true })
 cpSync(skillDir, skillDest, { recursive: true })
 console.log(`Installed Atoll skill to ${skillDest}`)
+if (existsSync(legacySkillDest)) {
+  rmSync(legacySkillDest, { recursive: true, force: true })
+  console.log(`Removed legacy Atoll skill at ${legacySkillDest}`)
+}
 
 // 2. Write AGENTS.md to ~/.codex/
 const skillMd = readFileSync(join(skillDir, 'SKILL.md'), 'utf-8')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-codex",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Install the Atoll project management integration for Codex CLI",
   "bin": {
     "skill-codex": "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.