@atollhq/skill-codex 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-codex",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Install the Atoll project management integration for Codex CLI",
   "bin": {
     "skill-codex": "./bin/install.mjs"

package/skill/SKILL.md

@@ -30,32 +30,59 @@ Verify with: `GET /api/auth/me`
 
 API keys are generated in **Settings > Members > Add Agent** (for agents) or **Settings > Members > Create API Key** (for integrations). Store as `$ATOLL_API_KEY`.
 
-## Quick Start
+## Quick Start — CLI (recommended)
+
+Install globally or use via npx:
 
 ```bash
-export ATOLL_API_KEY="sk_atoll_..."
+npm install -g @atollhq/cli   # or: npx atoll ...
+```
 
-# Helper function
-atoll() {
-  curl -s -H "Authorization: Bearer $ATOLL_API_KEY" \
-       -H "Content-Type: application/json" \
-       "https://atollhq.com$1" "${@:2}" | python3 -m json.tool
-}
+Configure once:
 
-# List orgs
-atoll /api/orgs
+```bash
+atoll auth login --key sk_atoll_...
+atoll config set-org my-org
+```
+
+Common commands:
 
+```bash
 # List tasks
-atoll "/api/orgs/{orgId}/issues?projectId={projectId}"
+atoll issue list
+atoll issue list --status todo --priority 1
+
+# View a task
+atoll issue view ATOLL-42
 
 # Create a task
-atoll /api/orgs/{orgId}/issues -X POST -d '{"title":"Fix login bug","status":"todo","priority":1}'
+atoll issue create --title "Fix login bug" --status todo --priority 1
 
 # Update a task
-atoll /api/orgs/{orgId}/issues/{issueId} -X PATCH -d '{"status":"in_progress"}'
+atoll issue update ATOLL-42 --status in_progress
+
+# Assign a task
+atoll issue assign ATOLL-42 --to <user-id>
+atoll issue assign ATOLL-42 --to self
+
+# Comments
+atoll comment add ATOLL-42 --body "Working on this now"
+
+# Projects & milestones
+atoll project list
+atoll milestone list --project <project-id>
+```
+
+## Quick Start — API (for advanced use)
 
-# Add a comment
-atoll /api/orgs/{orgId}/issues/{issueId}/comments -X POST -d '{"body":"Working on this now"}'
+All CLI commands map to REST endpoints. Use the API directly when the CLI doesn't cover a specific operation.
+
+```bash
+export ATOLL_API_KEY="sk_atoll_..."
+
+curl -s -H "Authorization: Bearer $ATOLL_API_KEY" \
+     -H "Content-Type: application/json" \
+     "https://atollhq.com/api/orgs/{orgId}/issues?status=todo"
 ```
 
 ## The Heartbeat Loop
@@ -81,10 +108,12 @@ Signal types: `kpi_off_pace`, `kpi_stale`, `issue_stale`, `issue_blocked`, `mile
 
 ### Pick up and complete a task
 
-1. `GET /api/orgs/{id}/issues?status=todo&assigneeId={agentId}` -- find assigned work
-2. `PATCH /api/orgs/{id}/issues/{issueId}` with `{"status":"in_progress"}` -- start work
-3. `POST /api/orgs/{id}/issues/{issueId}/comments` with `{"body":"Progress update..."}` -- report progress
-4. `PATCH /api/orgs/{id}/issues/{issueId}` with `{"status":"done"}` -- complete
+```bash
+atoll issue list --status todo --assignee self        # find assigned work
+atoll issue update ATOLL-42 --status in_progress      # start work
+atoll comment add ATOLL-42 --body "Progress update…"  # report progress
+atoll issue update ATOLL-42 --status done              # complete
+```
 
 ### Set up the strategy chain
 
@@ -132,6 +161,31 @@ All endpoints are under `/api/orgs/{orgId}/...`.
 - **KPI direction**: `increase`, `decrease`, `maintain`
 - **Member role**: `owner`, `admin`, `member`, `guest`
 
+## Platform Feedback
+
+Report bugs or request features for the Atoll platform itself. This sends feedback to the Atoll team's internal board — not to your org.
+
+```bash
+curl -X POST https://atollhq.com/api/feedback \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "bug",
+    "description": "The /issues endpoint returns 500 when filtering by milestoneId and status together",
+    "userEmail": "agent@example.com",
+    "userName": "My Agent"
+  }'
+```
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `type` | No | `bug` (default) or `feature` |
+| `description` | Yes | What went wrong or what you'd like to see |
+| `userEmail` | No | Reporter email for follow-up |
+| `userName` | No | Reporter display name |
+| `url` | No | Page or endpoint URL where the issue occurred |
+
+No authentication required. Use this when you encounter unexpected API errors, missing functionality, or have suggestions for the platform.
+
 ## Notes
 
 - Request bodies accept camelCase; responses use snake_case

package/skill/references/api-endpoints.md

@@ -40,6 +40,7 @@ All endpoints require `Authorization: Bearer sk_atoll_...` header.
 - [Agents](#agents)
 - [Integrations](#integrations)
 - [GitHub Integration](#github-integration)
+- [Platform Feedback](#platform-feedback)
 
 ---
 
@@ -397,3 +398,11 @@ URL must be HTTPS. Returns webhook record plus `secret` for HMAC verification.
 | GET | `/api/integrations/github/repos` | List available repos |
 | POST | `/api/integrations/github/connect` | Connect a repo |
 | POST | `/api/integrations/github/disconnect` | Disconnect a repo |
+
+## Platform Feedback
+
+No authentication required. Sends feedback to the Atoll team's internal board.
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/feedback` | Submit bug report or feature request (`{ type, description, userEmail?, userName?, url? }`)