openclaw-productboard 1.0.0

package/dist/utils/rate-limiter.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Token Bucket Rate Limiter for ProductBoard API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+exports.getRateLimiter = getRateLimiter;
+exports.resetRateLimiter = resetRateLimiter;
+const DEFAULT_OPTIONS = {
+    maxTokens: 100, // 100 requests
+    refillRate: 100, // Refill completely
+    refillInterval: 60 * 1000, // Per minute
+};
+class RateLimiter {
+    tokens;
+    lastRefill;
+    options;
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.tokens = this.options.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Refill tokens based on elapsed time
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const intervals = Math.floor(elapsed / this.options.refillInterval);
+        if (intervals > 0) {
+            this.tokens = Math.min(this.options.maxTokens, this.tokens + intervals * this.options.refillRate);
+            this.lastRefill = now - (elapsed % this.options.refillInterval);
+        }
+    }
+    /**
+     * Try to acquire a token
+     * @returns true if token was acquired, false if rate limited
+     */
+    tryAcquire() {
+        this.refill();
+        if (this.tokens > 0) {
+            this.tokens--;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Acquire a token, waiting if necessary
+     * @returns Promise that resolves when a token is available
+     */
+    async acquire() {
+        if (this.tryAcquire()) {
+            return;
+        }
+        // Wait until next refill
+        const waitTime = this.getWaitTime();
+        await this.sleep(waitTime);
+        await this.acquire();
+    }
+    /**
+     * Get the time in milliseconds until a token is available
+     */
+    getWaitTime() {
+        this.refill();
+        if (this.tokens > 0) {
+            return 0;
+        }
+        const elapsed = Date.now() - this.lastRefill;
+        return this.options.refillInterval - elapsed;
+    }
+    /**
+     * Get current token count
+     */
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+    /**
+     * Reset the rate limiter to full capacity
+     */
+    reset() {
+        this.tokens = this.options.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Check if rate limited without consuming a token
+     */
+    isRateLimited() {
+        this.refill();
+        return this.tokens <= 0;
+    }
+    /**
+     * Get rate limiter statistics
+     */
+    stats() {
+        return {
+            tokens: this.getTokens(),
+            maxTokens: this.options.maxTokens,
+            waitTime: this.getWaitTime(),
+        };
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.RateLimiter = RateLimiter;
+// Singleton instance for the plugin
+let rateLimiterInstance = null;
+function getRateLimiter(options) {
+    if (!rateLimiterInstance) {
+        rateLimiterInstance = new RateLimiter(options);
+    }
+    return rateLimiterInstance;
+}
+function resetRateLimiter() {
+    rateLimiterInstance = null;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmF0ZS1saW1pdGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL3JhdGUtbGltaXRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7OztBQW9JSCx3Q0FLQztBQUVELDRDQUVDO0FBbElELE1BQU0sZUFBZSxHQUF1QjtJQUMxQyxTQUFTLEVBQUUsR0FBRyxFQUFFLGVBQWU7SUFDL0IsVUFBVSxFQUFFLEdBQUcsRUFBRSxvQkFBb0I7SUFDckMsY0FBYyxFQUFFLEVBQUUsR0FBRyxJQUFJLEVBQUUsYUFBYTtDQUN6QyxDQUFDO0FBRUYsTUFBYSxXQUFXO0lBQ2QsTUFBTSxDQUFTO0lBQ2YsVUFBVSxDQUFTO0lBQ1YsT0FBTyxDQUFxQjtJQUU3QyxZQUFZLFVBQXVDLEVBQUU7UUFDbkQsSUFBSSxDQUFDLE9BQU8sR0FBRyxFQUFFLEdBQUcsZUFBZSxFQUFFLEdBQUcsT0FBTyxFQUFFLENBQUM7UUFDbEQsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQztRQUNyQyxJQUFJLENBQUMsVUFBVSxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztJQUMvQixDQUFDO0lBRUQ7O09BRUc7SUFDSyxNQUFNO1FBQ1osTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ3ZCLE1BQU0sT0FBTyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUMsVUFBVSxDQUFDO1FBQ3RDLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxDQUFDLENBQUM7UUFFcEUsSUFBSSxTQUFTLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDbEIsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsR0FBRyxDQUNwQixJQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFDdEIsSUFBSSxDQUFDLE1BQU0sR0FB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cmQgQVBJXG4gKi9cblxuZXhwb3J0IGludGVyZmFjZSBSYXRlTGltaXRlck9wdGlvbnMge1xuICAvKiogTWF4aW11bSB0b2tlbnMgaW4gdGhlIGJ1Y2tldCAqL1xuICBtYXhUb2tlbnM6IG51bWJlcjtcbiAgLyoqIFRva2VucyBhZGRlZCBwZXIgaW50ZXJ2YWwgKi9cbiAgcmVmaWxsUmF0ZTogbnVtYmVyO1xuICAvKiogUmVmaWxsIGludGVydmFsIGluIG1pbGxpc2Vjb25kcyAqL1xuICByZWZpbGxJbnRlcnZhbDogbnVtYmVyO1xufVxuXG5jb25zdCBERUZBVUxUX09QVElPTlM6IFJhdGVMaW1pdGVyT3B0aW9ucyA9IHtcbiAgbWF4VG9rZW5zOiAxMDAsIC8vIDEwMCByZXF1ZXN0c1xuICByZWZpbGxSYXRlOiAxMDAsIC8vIFJlZmlsbCBjb21wbGV0ZWx5XG4gIHJlZmlsbEludGVydmFsOiA2MCAqIDEwMDAsIC8vIFBlciBtaW51dGVcbn07XG5cbmV4cG9ydCBjbGFzcyBSYXRlTGltaXRlciB7XG4gIHByaXZhdGUgdG9rZW5zOiBudW1iZXI7XG4gIHByaXZhdGUgbGFzdFJlZmlsbDogbnVtYmVyO1xuICBwcml2YXRlIHJlYWRvbmx5IG9wdGlvbnM6IFJhdGVMaW1pdGVyT3B0aW9ucztcblxuICBjb25zdHJ1Y3RvcihvcHRpb25zOiBQYXJ0aWFsPFJhdGVMaW1pdGVyT3B0aW9ucz4gPSB7fSkge1xuICAgIHRoaXMub3B0aW9ucyA9IHsgLi4uREVGQVVMVF9PUFRJT05TLCAuLi5vcHRpb25zIH07XG4gICAgdGhpcy50b2tlbnMgPSB0aGlzLm9wdGlvbnMubWF4VG9rZW5zO1xuICAgIHRoaXMubGFzdFJlZmlsbCA9IERhdGUubm93KCk7XG4gIH1cblxuICAvKipcbiAgICogUmVmaWxsIHRva2VucyBiYXNlZCBvbiBlbGFwc2VkIHRpbWVcbiAgICovXG4gIHByaXZhdGUgcmVmaWxsKCk6IHZvaWQge1xuICAgIGNvbnN0IG5vdyA9IERhdGUubm93KCk7XG4gICAgY29uc3QgZWxhcHNlZCA9IG5vdyAtIHRoaXMubGFzdFJlZmlsbDtcbiAgICBjb25zdCBpbnRlcnZhbHMgPSBNYXRoLmZsb29yKGVsYXBzZWQgLyB0aGlzLm9wdGlvbnMucmVmaWxsSW50ZXJ2YWwpO1xuXG4gICAgaWYgKGludGVydmFscyA+IDApIHtcbiAgICAgIHRoaXMudG9rZW5zID0gTWF0aC5taW4oXG4gICAgICAgIHRoaXMub3B0aW9ucy5tYXhUb2tlbnMsXG4gICAgICAgIHRoaXMudG9rZW5zICsgaW50ZXJ2YWxzICogdGhpcy5vcHRpb25zLnJlZmlsbFJhdGVcbiAgICAgICk7XG4gICAgICB0aGlzLmxhc3RSZWZpbGwgPSBub3cgLSAoZWxhcHNlZCAlIHRoaXMub3B0aW9ucy5yZWZpbGxJbnRlcnZhbCk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFRyeSB0byBhY3F1aXJlIGEgdG9rZW5cbiAgICogQHJldHVybnMgdHJ1ZSBpZiB0b2tlbiB3YXMgYWNxdWlyZWQsIGZhbHNlIGlmIHJhdGUgbGltaXRlZFxuICAgKi9cbiAgdHJ5QWNxdWlyZSgpOiBib29sZWFuIHtcbiAgICB0aGlzLnJlZmlsbCgpO1xuXG4gICAgaWYgKHRoaXMudG9rZW5zID4gMCkge1xuICAgICAgdGhpcy50b2tlbnMtLTtcbiAgICAgIHJldHVybiB0cnVlO1xuICAgIH1cblxuICAgIHJldHVybiBmYWxzZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBBY3F1aXJlIGEgdG9rZW4sIHdhaXRpbmcgaWYgbmVjZXNzYXJ5XG4gICAqIEByZXR1cm5zIFByb21pc2UgdGhhdCByZXNvbHZlcyB3aGVuIGEgdG9rZW4gaXMgYXZhaWxhYmxlXG4gICAqL1xuICBhc3luYyBhY3F1aXJlKCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGlmICh0aGlzLnRyeUFjcXVpcmUoKSkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIC8vIFdhaXQgdW50aWwgbmV4dCByZWZpbGxcbiAgICBjb25zdCB3YWl0VGltZSA9IHRoaXMuZ2V0V2FpdFRpbWUoKTtcbiAgICBhd2FpdCB0aGlzLnNsZWVwKHdhaXRUaW1lKTtcbiAgICBhd2FpdCB0aGlzLmFjcXVpcmUoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIHRpbWUgaW4gbWlsbGlzZWNvbmRzIHVudGlsIGEgdG9rZW4gaXMgYXZhaWxhYmxlXG4gICAqL1xuICBnZXRXYWl0VGltZSgpOiBudW1iZXIge1xuICAgIHRoaXMucmVmaWxsKCk7XG5cbiAgICBpZiAodGhpcy50b2tlbnMgPiAwKSB7XG4gICAgICByZXR1cm4gMDtcbiAgICB9XG5cbiAgICBjb25zdCBlbGFwc2VkID0gRGF0ZS5ub3coKSAtIHRoaXMubGFzdFJlZmlsbDtcbiAgICByZXR1cm4gdGhpcy5vcHRpb25zLnJlZmlsbEludGVydmFsIC0gZWxhcHNlZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgY3VycmVudCB0b2tlbiBjb3VudFxuICAgKi9cbiAgZ2V0VG9rZW5zKCk6IG51bWJlciB7XG4gICAgdGhpcy5yZWZpbGwoKTtcbiAgICByZXR1cm4gdGhpcy50b2tlbnM7XG4gIH1cblxuICAvKipcbiAgICogUmVzZXQgdGhlIHJhdGUgbGltaXRlciB0byBmdWxsIGNhcGFjaXR5XG4gICAqL1xuICByZXNldCgpOiB2b2lkIHtcbiAgICB0aGlzLnRva2VucyA9IHRoaXMub3B0aW9ucy5tYXhUb2tlbnM7XG4gICAgdGhpcy5sYXN0UmVmaWxsID0gRGF0ZS5ub3coKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVjayBpZiByYXRlIGxpbWl0ZWQgd2l0aG91dCBjb25zdW1pbmcgYSB0b2tlblxuICAgKi9cbiAgaXNSYXRlTGltaXRlZCgpOiBib29sZWFuIHtcbiAgICB0aGlzLnJlZmlsbCgpO1xuICAgIHJldHVybiB0aGlzLnRva2VucyA8PSAwO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCByYXRlIGxpbWl0ZXIgc3RhdGlzdGljc1xuICAgKi9cbiAgc3RhdHMoKTogeyB0b2tlbnM6IG51bWJlcjsgbWF4VG9rZW5zOiBudW1iZXI7IHdhaXRUaW1lOiBudW1iZXIgfSB7XG4gICAgcmV0dXJuIHtcbiAgICAgIHRva2VuczogdGhpcy5nZXRUb2tlbnMoKSxcbiAgICAgIG1heFRva2VuczogdGhpcy5vcHRpb25zLm1heFRva2VucyxcbiAgICAgIHdhaXRUaW1lOiB0aGlzLmdldFdhaXRUaW1lKCksXG4gICAgfTtcbiAgfVxuXG4gIHByaXZhdGUgc2xlZXAobXM6IG51bWJlcik6IFByb21pc2U8dm9pZD4ge1xuICAgIHJldHVybiBuZXcgUHJvbWlzZSgocmVzb2x2ZSkgPT4gc2V0VGltZW91dChyZXNvbHZlLCBtcykpO1xuICB9XG59XG5cbi8vIFNpbmdsZXRvbiBpbnN0YW5jZSBmb3IgdGhlIHBsdWdpblxubGV0IHJhdGVMaW1pdGVySW5zdGFuY2U6IFJhdGVMaW1pdGVyIHwgbnVsbCA9IG51bGw7XG5cbmV4cG9ydCBmdW5jdGlvbiBnZXRSYXRlTGltaXRlcihvcHRpb25zPzogUGFydGlhbDxSYXRlTGltaXRlck9wdGlvbnM+KTogUmF0ZUxpbWl0ZXIge1xuICBpZiAoIXJhdGVMaW1pdGVySW5zdGFuY2UpIHtcbiAgICByYXRlTGltaXRlckluc3RhbmNlID0gbmV3IFJhdGVMaW1pdGVyKG9wdGlvbnMpO1xuICB9XG4gIHJldHVybiByYXRlTGltaXRlckluc3RhbmNlO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gcmVzZXRSYXRlTGltaXRlcigpOiB2b2lkIHtcbiAgcmF0ZUxpbWl0ZXJJbnN0YW5jZSA9IG51bGw7XG59XG4iXX0=

package/openclaw.plugin.json

@@ -0,0 +1,57 @@
+{
+  "id": "productboard",
+  "name": "ProductBoard",
+  "version": "1.0.0",
+  "description": "ProductBoard integration for managing features, products, and customer feedback",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiToken": {
+        "type": "string",
+        "description": "ProductBoard API bearer token"
+      },
+      "apiBaseUrl": {
+        "type": "string",
+        "default": "https://api.productboard.com",
+        "description": "ProductBoard API base URL"
+      },
+      "cacheTtlSeconds": {
+        "type": "number",
+        "default": 300,
+        "description": "Cache TTL in seconds for read operations"
+      },
+      "rateLimitPerMinute": {
+        "type": "number",
+        "default": 100,
+        "description": "Maximum API requests per minute"
+      }
+    },
+    "required": ["apiToken"]
+  },
+  "uiHints": {
+    "apiToken": {
+      "label": "ProductBoard API Token",
+      "placeholder": "pb_...",
+      "sensitive": true,
+      "helpText": "Get your API token from ProductBoard Settings > Integrations > Public API"
+    },
+    "apiBaseUrl": {
+      "label": "API Base URL",
+      "placeholder": "https://api.productboard.com",
+      "helpText": "Only change if using a custom ProductBoard instance"
+    },
+    "cacheTtlSeconds": {
+      "label": "Cache TTL (seconds)",
+      "helpText": "How long to cache read operations"
+    },
+    "rateLimitPerMinute": {
+      "label": "Rate Limit (requests/minute)",
+      "helpText": "Maximum API requests per minute"
+    }
+  },
+  "skills": [
+    "skills/productboard-search",
+    "skills/productboard-feedback",
+    "skills/productboard-release"
+  ]
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "openclaw-productboard",
+  "version": "1.0.0",
+  "description": "OpenClaw plugin for ProductBoard integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "openclaw": {
+    "extensions": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "productboard",
+    "plugin",
+    "product-management",
+    "agent-tools",
+    "api-integration"
+  ],
+  "author": "Roberto Moreno",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robertoamoreno/openclaw-productboard.git"
+  },
+  "homepage": "https://github.com/robertoamoreno/openclaw-productboard#readme",
+  "bugs": {
+    "url": "https://github.com/robertoamoreno/openclaw-productboard/issues"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "lru-cache": "^10.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ]
+}

package/skills/productboard-feedback/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: productboard-feedback
+description: Create and manage customer feedback notes in ProductBoard
+user-invocable: true
+---
+
+# ProductBoard Feedback Skill
+
+Capture customer feedback, feature requests, and user insights in ProductBoard. Link feedback to features to aggregate customer evidence.
+
+## Available Tools
+
+- `pb_note_create` - Create a new customer feedback note
+- `pb_note_list` - List existing notes
+- `pb_note_attach` - Link a note to a feature
+- `pb_feature_search` - Find features to link notes to
+- `pb_feature_list` - List features for context
+
+## Capturing Feedback
+
+### Creating Notes
+
+Use `pb_note_create` with:
+
+**Required**:
+- `content` - The feedback text (supports HTML)
+
+**Recommended**:
+- `title` - Brief summary of the feedback
+- `userEmail` - Who provided the feedback
+- `userName` - User's name
+- `companyName` - Their company/organization
+- `tags` - Categories like "bug", "feature-request", "ux"
+
+**Optional**:
+- `displayUrl` - Link to original source (support ticket, Slack, etc.)
+- `sourceOrigin` - System identifier (e.g., "zendesk", "intercom")
+- `sourceRecordId` - ID in the source system
+
+### Linking to Features
+
+1. Find the relevant feature using `pb_feature_search` or `pb_feature_list`
+2. Use `pb_note_attach` with the `noteId` and `featureId`
+
+## Workflow Examples
+
+### Capture Support Ticket Feedback
+
+```
+1. pb_note_create:
+   - content: "User reports login takes too long on mobile devices"
+   - title: "Slow mobile login"
+   - userEmail: "customer@company.com"
+   - userName: "Jane Smith"
+   - companyName: "Acme Corp"
+   - tags: ["performance", "mobile", "authentication"]
+   - sourceOrigin: "zendesk"
+   - sourceRecordId: "12345"
+   - displayUrl: "https://zendesk.com/tickets/12345"
+
+2. pb_feature_search with query "mobile login" to find related feature
+
+3. pb_note_attach to link the note to the feature
+```
+
+### Capture Feature Request
+
+```
+1. pb_note_create:
+   - content: "Would love to have dark mode support in the app"
+   - title: "Dark mode request"
+   - userEmail: "user@example.com"
+   - tags: ["feature-request", "ui", "accessibility"]
+
+2. pb_feature_search with query "dark mode"
+
+3. If feature exists: pb_note_attach
+   If not: Consider creating feature with pb_feature_create
+```
+
+### Batch Feedback Processing
+
+1. Use `pb_note_list` to review recent unlinked notes
+2. For each note, search for relevant features
+3. Attach notes to appropriate features
+
+## Best Practices
+
+- **Always include context**: Add user email, company, and source URL when available
+- **Use consistent tags**: Establish a tagging convention (bug, feature-request, ux, performance, etc.)
+- **Link to features**: Attached notes contribute to feature insights and prioritization
+- **Keep titles concise**: Use title for quick scanning, content for details
+- **Track the source**: Include sourceOrigin and sourceRecordId for traceability
+
+## Integration Points
+
+- **Support Systems**: Zendesk, Intercom, Freshdesk
+- **Communication**: Slack, Microsoft Teams, Email
+- **Sales/CRM**: Salesforce, HubSpot, Pipedrive
+- **User Research**: UserTesting, Hotjar, surveys
+
+When capturing feedback from these systems, always include:
+1. The original source URL (displayUrl)
+2. The system name (sourceOrigin)
+3. The record ID (sourceRecordId)

package/skills/productboard-release/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: productboard-release
+description: Manage ProductBoard releases and roadmap planning
+user-invocable: false
+metadata:
+  openclaw:
+    requires:
+      env:
+        - PRODUCTBOARD_API_TOKEN
+---
+
+# ProductBoard Release Planning Skill
+
+Plan and manage product releases by organizing features, tracking progress, and updating statuses in ProductBoard.
+
+## Available Tools
+
+- `pb_feature_create` - Create new features for releases
+- `pb_feature_update` - Update feature status and details
+- `pb_feature_list` - List features by status or product
+- `pb_feature_get` - Get detailed feature information
+- `pb_product_list` - List products
+- `pb_product_hierarchy` - View product structure
+- `pb_user_list` - Find users to assign as owners
+
+## Release Planning Workflow
+
+### 1. Review Current State
+
+```
+1. pb_product_hierarchy - Understand workspace structure
+2. pb_feature_list with status "candidate" - Review feature candidates
+3. pb_feature_list with status "in-progress" - Check ongoing work
+```
+
+### 2. Prioritize Features
+
+Review candidates and update their status:
+
+```
+pb_feature_update:
+  - id: "feature-id"
+  - status: "in-progress"  // Move to active development
+```
+
+### 3. Assign Owners
+
+Find users and assign feature ownership:
+
+```
+1. pb_user_list - Get available team members
+2. pb_feature_update:
+   - id: "feature-id"
+   - ownerEmail: "developer@company.com"
+```
+
+### 4. Set Timeframes
+
+Add planning dates to features:
+
+```
+pb_feature_update:
+  - id: "feature-id"
+  - startDate: "2024-01-15"
+  - endDate: "2024-02-15"
+```
+
+### 5. Track Progress
+
+Monitor feature statuses:
+
+```
+pb_feature_list with status "in-progress" - Active development
+pb_feature_list with status "shipped" - Completed features
+```
+
+## Feature Status Lifecycle
+
+| Status | Description |
+|--------|-------------|
+| `new` | Just created, not yet evaluated |
+| `candidate` | Being considered for development |
+| `in-progress` | Actively being developed |
+| `shipped` | Released to customers |
+| `postponed` | Deferred to future planning |
+| `archived` | No longer relevant |
+
+## Planning Scenarios
+
+### Sprint Planning
+
+1. List candidates: `pb_feature_list` with status "candidate"
+2. Review each feature: `pb_feature_get` for details
+3. Move selected features to in-progress: `pb_feature_update`
+4. Assign owners: `pb_feature_update` with ownerEmail
+5. Set sprint dates: `pb_feature_update` with startDate/endDate
+
+### Release Retrospective
+
+1. List shipped features: `pb_feature_list` with status "shipped"
+2. Review feedback on features: Use feedback skill tools
+3. Archive completed work: `pb_feature_update` with status "archived"
+
+### Quarterly Planning
+
+1. Review product hierarchy: `pb_product_hierarchy`
+2. List all active features by product
+3. Reassess priorities and update statuses
+4. Create new features as needed: `pb_feature_create`
+
+## Organizing Features
+
+### By Product
+
+```
+pb_feature_create:
+  - name: "Feature name"
+  - productId: "product-id"
+  - status: "candidate"
+```
+
+### By Component
+
+```
+pb_feature_create:
+  - name: "Feature name"
+  - componentId: "component-id"
+  - status: "candidate"
+```
+
+### As Sub-feature
+
+```
+pb_feature_create:
+  - name: "Sub-feature name"
+  - parentFeatureId: "parent-feature-id"
+```
+
+## Best Practices
+
+1. **Use consistent statuses**: Move features through the lifecycle systematically
+2. **Assign owners early**: Clear ownership improves accountability
+3. **Set realistic timeframes**: Update dates as plans change
+4. **Organize hierarchically**: Use products, components, and sub-features
+5. **Archive completed work**: Keep the backlog clean by archiving shipped features
+6. **Review regularly**: Use listing tools to audit feature states

package/skills/productboard-search/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: productboard-search
+description: Search and explore ProductBoard features, products, and feedback
+user-invocable: true
+---
+
+# ProductBoard Search Skill
+
+Search and explore your ProductBoard workspace to find features, products, components, and customer feedback.
+
+## Available Tools
+
+- `pb_search` - Global search across all ProductBoard entities
+- `pb_feature_list` - List features with filters
+- `pb_feature_get` - Get detailed feature information
+- `pb_feature_search` - Search features by name/description
+- `pb_product_list` - List all products
+- `pb_product_get` - Get product details with components
+- `pb_product_hierarchy` - View full product/component tree
+- `pb_note_list` - List customer feedback notes
+
+## Search Strategies
+
+### Finding Features
+
+1. **By keyword**: Use `pb_feature_search` with a query term
+2. **By product**: Use `pb_feature_list` with `productId` filter
+3. **By status**: Use `pb_feature_list` with `status` filter (new, in-progress, shipped, archived)
+4. **By component**: Use `pb_feature_list` with `componentId` filter
+
+### Understanding Structure
+
+1. Start with `pb_product_hierarchy` to see the complete workspace organization
+2. Use `pb_product_get` to explore a specific product and its components
+3. Filter features by product or component to narrow down results
+
+### Finding Customer Feedback
+
+1. Use `pb_note_list` to see recent feedback
+2. Filter by date range using `createdFrom` and `createdTo`
+3. Use `pb_search` with type `note` to find specific feedback
+
+## Example Queries
+
+**User**: "Find all features related to authentication"
+**Action**: Use `pb_feature_search` with query "authentication"
+
+**User**: "What features are currently in progress?"
+**Action**: Use `pb_feature_list` with status "in-progress"
+
+**User**: "Show me the product structure"
+**Action**: Use `pb_product_hierarchy` to get the full tree
+
+**User**: "Find customer feedback about performance"
+**Action**: Use `pb_search` with query "performance" and type "note"
+
+## Tips
+
+- Start broad with `pb_search`, then narrow down with specific tools
+- Use `pb_product_hierarchy` first when exploring an unfamiliar workspace
+- The search is case-insensitive and matches partial words
+- Results include direct links to ProductBoard for quick access