add claude skills

Author: disnet

.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+ "name": "at-kanban",
+ "description": "Skyboard plugins",
+ "owner": {
+ "name": "disnet"
+  },
+ "plugins": [
+    {
+ "name": "sb",
+ "version": "0.1.0",
+ "description": "Skyboard kanban board CLI — manage boards, columns, and cards on AT Protocol",
+ "source": "./"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+ "name": "sb",
+ "version": "0.1.0",
+ "description": "Skyboard kanban board CLI — manage boards, columns, and cards on AT Protocol",
+ "author": {
+ "name": "disnet"
+  },
+ "keywords": ["kanban", "atproto", "skyboard", "cli"]
+}

cli/README.md

@@ -104,6 +104,29 @@ sb boards --json
 sb whoami --json
 ```
 
+## Claude Code plugin
+
+The `sb` CLI includes a [Claude Code](https://claude.ai/code) plugin so you can manage boards directly from a Claude Code conversation using `/sb:cards`, `/sb:new`, `/sb:mv`, etc.
+
+### Install the plugin
+
+```bash
+# Add the marketplace (once)
+/plugin marketplace add /path/to/skyboard
+
+# Install the plugin
+/plugin install sb@skyboard
+```
+
+Or from the terminal:
+
+```bash
+claude plugin marketplace add /path/to/skyboard
+claude plugin install sb@skyboard --scope user
+```
+
+Restart Claude Code after installing. All 15 `sb` commands are available as skills (e.g. `/sb:status`, `/sb:cards`, `/sb:new`).
+
 ## How it works
 
 The CLI authenticates via OAuth and talks directly to AT Protocol PDS endpoints — there is no local database. Each command fetches fresh data from the board owner's PDS and all trusted participants, runs the same `materializeTasks()` per-field LWW merge logic as the web app, and displays the result.

commands/add.md

@@ -0,0 +1,20 @@
+---
+description: "Join a board by link"
+argument-hint: "<link>"
+---
+
+# sb add
+
+Join a board by its AT URI or web URL.
+
+## Usage
+
+```
+sb add <link>
+```
+
+- `<link>` — AT URI (`at://did:plc:xxx/dev.skyboard.board/rkey`) or web URL (`https://skyboard.dev/board/...`)
+
+If the user doesn't provide a link, ask them for it.
+
+This command does not support `--json`.

commands/boards.md

@@ -0,0 +1,18 @@
+---
+description: "List all boards (owned and joined)"
+argument-hint: ""
+---
+
+# sb boards
+
+List all boards the user owns or has joined.
+
+## Usage
+
+```
+sb boards --json
+```
+
+Always use `--json`. Returns an array of boards with: `rkey`, `did`, `name`, `description`, `columns`, `open`.
+
+Present as a numbered list showing board name, column count, and whether the board is open.

commands/cards.md

@@ -0,0 +1,24 @@
+---
+description: "List cards, optionally filtered by column, label, or search text"
+argument-hint: ""
+---
+
+# sb cards
+
+List cards on the current board, grouped by column.
+
+## Usage
+
+```
+sb cards --json
+```
+
+Options:
+- `-c, --column <column>` — filter by column (name, prefix, or 1-based index)
+- `-l, --label <label>` — filter by label name
+- `-s, --search <text>` — search in title and description
+- `--board <ref>` — override default board
+
+Always use `--json`. Returns an array of column objects, each with a `cards[]` array containing: `rkey`, `shortRef`, `title`, `description`, `labels`, `createdAt`, `lastModifiedAt`.
+
+Present cards grouped by column. Show the short ref (for use in other commands), title, and labels if any.

commands/cols.md

@@ -0,0 +1,21 @@
+---
+description: "Show columns for the current board"
+argument-hint: ""
+---
+
+# sb cols
+
+Show columns for the current (or specified) board.
+
+## Usage
+
+```
+sb cols --json
+```
+
+Options:
+- `--board <ref>` — override default board
+
+Always use `--json`. Returns an array with: `index`, `id`, `name`, `taskCount`.
+
+Present as a numbered list showing column name and card count.

commands/comment.md

@@ -0,0 +1,24 @@
+---
+description: "Add a comment to a card"
+argument-hint: "<ref> <text>"
+---
+
+# sb comment
+
+Add a comment to a card.
+
+## Usage
+
+```
+sb comment <ref> "<text>" --json
+```
+
+- `<ref>` — card reference (rkey prefix, minimum 4 characters)
+- `<text>` — comment text
+
+Options:
+- `--board <ref>` — override default board
+
+Always use `--json`. Returns: `rkey`, `taskRkey`, `text`.
+
+If the user doesn't provide the card ref or comment text, ask for the missing pieces. Quote the comment text to handle spaces.

commands/edit.md

@@ -0,0 +1,26 @@
+---
+description: "Edit card fields (title, description, labels)"
+argument-hint: "<ref>"
+---
+
+# sb edit
+
+Edit one or more fields of a card.
+
+## Usage
+
+```
+sb edit <ref> --json
+```
+
+- `<ref>` — card reference (rkey prefix, minimum 4 characters)
+
+Options:
+- `-t, --title <title>` — new title
+- `-d, --description <desc>` — new description
+- `-l, --label <label...>` — set labels (can be specified multiple times)
+- `--board <ref>` — override default board
+
+At least one of `-t`, `-d`, or `-l` must be provided. Always use `--json`. Returns: `rkey`, `fields`.
+
+If the user doesn't specify what to change, ask them which fields to update.

commands/login.md

@@ -0,0 +1,22 @@
+---
+description: "Log in to Skyboard via AT Protocol OAuth"
+argument-hint: "<handle>"
+---
+
+# sb login
+
+Log in to Skyboard using your AT Protocol handle.
+
+## Usage
+
+```
+sb login <handle>
+```
+
+- `<handle>` — AT Protocol handle (e.g. `alice.bsky.social`)
+
+If the user doesn't provide a handle, ask them for it.
+
+This command opens a browser for OAuth authentication. Tell the user a browser window will open and they should complete login there.
+
+This command does not support `--json`.