fix: align all skills with actual CLI commands

Author: Walle

skills/getnote-auth/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: getnote-auth
-version: 0.1.0
+version: 0.2.0
 description: Manage authentication for Get笔记 CLI
 ---
 
 # getnote-auth Skill
 
-Log in, log out, and check authentication status for the `getnote` CLI.
+Log in, log out, and check authentication status.
 
 ## Commands
 
@@ -16,19 +16,16 @@ Log in, log out, and check authentication status for the `getnote` CLI.
 getnote auth login [--api-key <key>] [--client-id <id>]
 ```
 
-Two modes:
-
 | Mode | Command | Description |
 |------|---------|-------------|
-| OAuth (recommended) | `getnote auth login` | Opens browser to authorize; saves credentials automatically |
-| API Key | `getnote auth login --api-key <key>` | Saves API key directly, no browser needed |
+| OAuth (recommended) | `getnote auth login` | Opens browser to authorize |
+| API Key | `getnote auth login --api-key <key>` | Saves key directly, no browser |
 
-**Examples:**
 ```bash
-# OAuth flow (opens browser)
+# OAuth flow
 getnote auth login
 
-# Direct API key
+# API key directly
 getnote auth login --api-key gk_live_xxx
 
 # API key + Client ID
@@ -45,9 +42,6 @@ API keys start with `gk_live_`. Get yours at: https://www.biji.com/settings/deve
 getnote auth status
 ```
 
-Shows whether the CLI is authenticated and which API key is in use.
-
-**Example:**
 ```bash
 getnote auth status
 ```
@@ -60,9 +54,8 @@ getnote auth status
 getnote auth logout
 ```
 
-Removes the saved API key from local config.
+Removes saved credentials from local config.
 
-**Example:**
 ```bash
 getnote auth logout
 ```
@@ -71,7 +64,7 @@ getnote auth logout
 
 ## Agent Usage Notes
 
-- Always run `getnote auth status` before other commands to verify authentication.
+- Always run `getnote auth status` first to verify authentication before other commands.
 - If not authenticated, prompt the user to run `getnote auth login`.
-- The `--api-key` flag on any command overrides the saved config temporarily (does not save).
-- Credentials are stored locally; `auth logout` removes them.
+- `--api-key` on any command is a temporary override and does not save credentials.
+- Credentials are stored in `~/.getnote/config.json`; `auth logout` removes them.

skills/getnote-kb/SKILL.md

@@ -1,77 +1,61 @@
 ---
 name: getnote-kb
-version: 0.1.0
+version: 0.2.0
 description: Manage knowledge bases in Get笔记 via the getnote CLI
 ---
 
 # getnote-kb Skill
 
-Manage knowledge bases (话题/topic) in Get笔记 — list, create, and add or remove notes.
+Manage knowledge bases in Get笔记 — list, create, browse notes, add/remove notes.
 
 ## Prerequisites
 
 - `getnote` CLI installed and authenticated (`getnote auth status` should show "Authenticated")
-- API key configured via `getnote auth login --api-key <key>` or the `GETNOTE_API_KEY` environment variable
 
 ## Commands
 
-### List knowledge bases
+### List all knowledge bases
 
 ```
-getnote kb list [--output json|table]
+getnote kbs
 ```
 
-Returns all knowledge bases accessible to the authenticated user.
-
-**Examples:**
 ```bash
-# Human-friendly table
-getnote kb list
-
-# Machine-readable JSON
-getnote kb list --output json
+getnote kbs
+getnote kbs -o json
 ```
 
 ---
 
-### Create a knowledge base
+### List notes in a knowledge base
 
 ```
-getnote kb create <name> [--desc <description>]
+getnote kb <topic_id> [--limit <n>] [--all]
 ```
 
-| Flag | Description |
-|------|-------------|
-| `--desc` | Optional description for the knowledge base |
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--limit` | 20 | Notes per page |
+| `--all` | — | Fetch all notes (auto-paginate) |
 
-**Examples:**
 ```bash
-getnote kb create "Research Papers"
-getnote kb create "Project Docs" --desc "Documentation links for the main project"
+getnote kb vnrOAaGY
+getnote kb vnrOAaGY --limit 5
+getnote kb vnrOAaGY --all
+getnote kb vnrOAaGY -o json
 ```
 
 ---
 
-### List notes in a knowledge base
+### Create a knowledge base
 
 ```
-getnote kb notes <topic_id> [--limit <n>] [--output json|table]
+getnote kb create <name> [--desc <description>]
 ```
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--limit` | 20 | Maximum number of notes to return |
-
-**Examples:**
 ```bash
-# List notes in a knowledge base
-getnote kb notes kb_abc123
-
-# Get more results
-getnote kb notes kb_abc123 --limit 50
-
-# Machine-readable output
-getnote kb notes kb_abc123 --output json
+getnote kb create "Research Papers"
+getnote kb create "Project Docs" --desc "Documentation links for the main project"
 ```
 
 ---
@@ -82,15 +66,11 @@ getnote kb notes kb_abc123 --output json
 getnote kb add <topic_id> <note_id> [note_id...]
 ```
 
-Supports adding multiple notes in a single call.
+Supports multiple note IDs in one call.
 
-**Examples:**
 ```bash
-# Add a single note
-getnote kb add kb_abc123 note_xyz789
-
-# Add multiple notes at once
-getnote kb add kb_abc123 note_xyz789 note_def456 note_ghi012
+getnote kb add vnrOAaGY 1234567890
+getnote kb add vnrOAaGY 1234567890 9876543210
 ```
 
 ---
@@ -101,23 +81,16 @@ getnote kb add kb_abc123 note_xyz789 note_def456 note_ghi012
 getnote kb remove <topic_id> <note_id> [note_id...]
 ```
 
-Supports removing multiple notes in a single call.
-
-**Examples:**
 ```bash
-# Remove a single note
-getnote kb remove kb_abc123 note_xyz789
-
-# Remove multiple notes at once
-getnote kb remove kb_abc123 note_xyz789 note_def456
+getnote kb remove vnrOAaGY 1234567890
+getnote kb remove vnrOAaGY 1234567890 9876543210
 ```
 
 ---
 
 ## Agent Usage Notes
 
-- Use `--output json` for all commands when parsing responses programmatically.
-- To get a `topic_id`, first call `getnote kb list --output json` and extract the `id` field.
-- `kb add` and `kb remove` accept multiple note IDs in a single call — prefer batching over multiple calls.
+- Use `-o json` when parsing results programmatically.
+- Get `topic_id` from `getnote kbs -o json` (the `id` field).
+- `kb add` / `kb remove` accept multiple note IDs — prefer batching over multiple calls.
 - Exit code `0` = success; non-zero = error. Error details go to stderr.
-- Combine with `getnote note list --output json` to get note IDs before adding them to a knowledge base.