html-publisher-skills

# Tool List [HTML Publisher](https://github.com/cti1650/html-publisher) A marketplace for Claude Code plugins for MCP Server. ## Overview A collection of skills to guide the workflow when AI agents create and manage HTML tools using HTML Publisher, provided as a Claude Code plugin marketplace. **Prerequisites:** HTML Publisher MCP server must be set up separately. ## Included Plugins ### `html-publisher-skills` | Skill | Description | |--------|-------------| | `publish-html` | Create, update, and publish HTML content workflow (persistent/ephemeral mode support) | | `manage-tools` | Confirm tool list, share QR code, and manage Gist | ## Supported HTML Publisher Features This skill set supports the following HTML Publisher features: - **Persistent Mode (Gist)**: Traditional publishing method saved to GitHub Gist - **Ephemeral Mode (cache, `ephemeral: true`)**: Cached and saved to Upstash Redis, automatically deleted after approximately 5-6 hours from last access. Ideal for hackathons and temporary sharing - **Automatic Ephemeral Mode for Anonymous Access**: Automatically switches to ephemeral mode when accessed without an API key (persistent Gist writing requires authentication) - **`how_to_use` Tool embedded in MCP Server**: Allows clients without installed skills to obtain usage guides ## Installation ### Install from Marketplace (Recommended) ```bash # Add marketplace claude plugin marketplace add cti1650/html-publisher-skills # Install plugin claude plugin install html-publisher-skills@html-publisher-marketplace ``` ### Test Locally ```bash git clone https://github.com/cti1650/html-publisher-skills.git claude --plugin-dir ./html-publisher-skills ``` ### Claude Web Version (claude.ai) Download individual skill zips from [Releases](https://github.com/cti1650/html-publisher-skills/releases) and import them. - `publish-html.zip` - `manage-tools.zip` Zips can also be generated using `npm run build`. ## Update ```bash # Update marketplace to latest claude plugin marketplace update html-publisher-marketplace # Reinstall plugin claude plugin install html-publisher-skills@html-publisher-marketplace ``` ## Uninstallation ```bash # Remove plugin claude plugin uninstall html-publisher-skills@html-publisher-marketplace # Remove marketplace (plugins will also be removed) claude plugin marketplace remove html-publisher-marketplace ``` ## MCP Server Setup This plugin requires a connection to the HTML Publisher MCP server. ### Ephemeral Mode Only (No API Key Required) Use a publicly deployed instance or if persistence is not needed. In this case, created tools will be automatically deleted in approximately 5-6 hours from last access in ephemeral mode. ```json { "mcpServers": { "html-publisher": { "url": "https://your-domain.com/api/mcp/mcp" } } } ``` stdio client: ```json { "mcpServers": { "html-publisher": { "command": "npx", "args": ["-y", "mcp-remote", "https://your-domain.com/api/mcp/mcp"] } } } ``` ### Persistent Mode Support (API Key Authentication) For persistent saving to GitHub Gist or using `import_gist`, connect with API key authentication. ```json { "mcpServers": { "html-publisher": { "url": "https://your-domain.com/api/mcp/mcp?key=your-api-key" } } } ``` stdio client: ```json { "mcpServers": { "html-publisher": { "command": "npx", "args": ["-y", "mcp-remote", "https://your-domain.com/api/mcp/mcp?key=your-api-key"] } } } ``` ## Development ### Directory Structure ``` html-publisher-skills/ # Marketplace root ├── .claude-plugin/ │ └── marketplace.json # Marketplace definition ├── plugins/ │ └── html-publisher-skills/ # Plugin (multiple additions possible) │ ├── .claude-plugin/ │ │ └── plugin.json # Plugin manifest │ └── skills/ │ ├── publish-html/SKILL.md │ └── manage-tools/SKILL.md ├── scripts/ │ └── build-zip.mjs # Zip build script └── package.json ``` To add a new plugin, create a directory under `plugins/` and add an entry to the `plugins` array in `.claude-plugin/marketplace.json`. ### Build ```bash npm run build ``` The following files will be generated in `dist/`: | File | Purpose | |---------|----------| | `html-publisher-marketplace.zip` | Marketplace set (for offline distribution) | | `html-publisher-skills.zip` | Individual plugin (for `--plugin-dir`) | | `publish-html.zip` | Import for Claude Web version (individual skill) | | `manage-tools.zip` | Import for Claude Web version (individual skill) | ### Validation ```bash claude plugin validate . ``` ## Commands - `claude plugin ...` format is for CLI mode (can be executed from anywhere) - `/plugin ...` format is for Claude Code interactive session only - Both provide equivalent functionality ## License MIT