feat: add Claude Code marketplace plugin

.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "pchuri-confluence-cli",
+  "owner": {
+    "name": "pchuri"
+  },
+  "metadata": {
+    "description": "Claude Code plugins for Atlassian Confluence CLI.",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "confluence",
+      "description": "Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.",
+      "source": "./plugins/confluence"
+    }
+  ]
+}

README.md

@@ -40,17 +40,28 @@ Or run directly with npx:
 npx confluence-cli
 ```
 
-## Claude Code AI Skills
+## Claude Code Integration
 
-If you use [Claude Code](https://claude.ai/code) or any AI agent that reads `.claude/skills/`, install the skill documentation so the agent understands all confluence-cli commands automatically.
+confluence-cli ships as a [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/plugins). Once installed, Claude Code understands all confluence-cli commands automatically and receives updates when the skill is improved.
 
-Run this from your project root after installing confluence-cli:
+### Option 1: Install as Plugin (recommended)
+
+Add the marketplace and install the plugin:
+
+```bash
+/plugin marketplace add pchuri/confluence-cli
+/plugin install confluence@pchuri-confluence-cli
+```
+
+### Option 2: Install Skill manually
+
+If you prefer not to use the plugin system, copy the skill documentation into your project:
 
 ```bash
 confluence install-skill
 ```
 
-This creates `.claude/skills/confluence/SKILL.md` in your current directory. Claude Code picks it up automatically and can help you with any confluence-cli command.
+This creates `.claude/skills/confluence/SKILL.md` in your current directory. Claude Code picks it up automatically.
 
 ## Quick Start
 

bin/confluence.js

@@ -167,7 +167,7 @@ program
     const fs = require('fs');
     const path = require('path');
 
-    const skillSrc = path.join(__dirname, '..', '.claude', 'skills', 'confluence', 'SKILL.md');
+    const skillSrc = path.join(__dirname, '..', 'plugins', 'confluence', 'skills', 'confluence', 'SKILL.md');
 
     if (!fs.existsSync(skillSrc)) {
       console.error(chalk.red('Error: skill file not found in package. Try reinstalling confluence-cli.'));

package.json

@@ -58,7 +58,7 @@
   "files": [
     "bin/",
     "lib/",
-    ".claude/skills/",
+    "plugins/",
     "npm-shrinkwrap.json"
   ]
 }

plugins/confluence/.claude-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "confluence",
+  "description": "Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.",
+  "version": "1.28.0",
+  "author": {
+    "name": "pchuri"
+  },
+  "homepage": "https://github.com/pchuri/confluence-cli#readme",
+  "repository": "https://github.com/pchuri/confluence-cli",
+  "license": "MIT",
+  "keywords": [
+    "confluence",
+    "atlassian",
+    "wiki",
+    "documentation",
+    "cli"
+  ]
+}

plugins/confluence/README.md

@@ -0,0 +1,27 @@
+# confluence
+
+A Claude Code plugin for [confluence-cli](https://github.com/pchuri/confluence-cli). Gives Claude Code full knowledge of all confluence-cli commands so it can read, search, create, update, move, delete, and convert Confluence pages and attachments on your behalf.
+
+## Installation
+
+Add the marketplace and install the plugin:
+
+```bash
+/plugin marketplace add pchuri/confluence-cli
+/plugin install confluence@pchuri-confluence-cli
+```
+
+## Prerequisites
+
+confluence-cli must be installed and configured:
+
+```bash
+npm install -g confluence-cli
+confluence init
+```
+
+See the [main README](../../README.md) for full configuration options.
+
+## What this plugin provides
+
+- **Skill: confluence** (model-invoked) — Claude Code automatically activates this skill when your task involves Confluence. It covers all 30+ CLI commands, configuration, common workflows, and error handling.

.claude/skills/confluence/SKILL.md → plugins/confluence/skills/confluence/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: confluence
 description: Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.
+argument-hint: <pageId, URL, search query, or task description>
+allowed-tools: [Bash, Read, Write, Glob, Grep]
 ---
 
 # confluence-cli Skill