v3.0.2: HTTPS install fallback

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "intercom-help-center",
   "displayName": "Intercom Help Center Article Writer for Claude Code",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Keep your Intercom help center true to your code: audit every article, map it to your features, plan fixes, write grounded articles, open PRs, and publish only what a human approved.",
   "author": {
     "name": "Odera Joseph",

CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project. The format follows [Keep a Changelog](https
 
 ## [Unreleased]
 
+## [3.0.2] - 2026-09-29
+
+Install docs only; the plugin itself is unchanged.
+
+### Added
+- **HTTPS install fallback**: the `owner/repo` shorthand clones over SSH, so it fails with "SSH authentication failed" / "Permission denied (publickey)" on a machine with no SSH key registered with GitHub. The README, the setup guide and the troubleshooting page now show the HTTPS form: `/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git`.
+
+### Changed
+- **GitHub Actions templates** pin `ref: v3.0.2`, and the README and setup guide show `#v3.0.2` as the release pin example.
+
+### Upgrading from 3.0.1
+- Nothing to do. If you copied a workflow from `templates/github/`, you can change its `ref:` to `v3.0.2`.
+
 ## [3.0.1] - 2026-09-29
 
 The repository is renamed to `Claude-Intercom-HelpCenter-Article-Writer`. Links and docs only; the plugin itself is unchanged.
@@ -85,7 +98,8 @@ The skill becomes a Claude Code plugin that manages the whole Help Center, not o
 ### Added
 - The `intercom-article-writer` skill: write help articles from code, a coverage manifest and CI gate (`coverage-check.mjs`), and a markdown-to-Intercom publisher (`publish.mjs`) with spacer paragraphs, H1 stripping, paginated collections, create-or-update by id with write-back, `--create-sections`, `--parity`, a dry-run default and a 20-article cap.
 
-[Unreleased]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.1...dev
+[Unreleased]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.2...dev
+[3.0.2]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.1...v3.0.2
 [3.0.1]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.0...v3.0.1
 [3.0.0]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v2.0.0...v3.0.0
 [2.0.0]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/881238a...v2.0.0

README.md

@@ -113,7 +113,13 @@ You get `.help-center/help-center-audit.md`. From there: `/intercom-help-center:
 /plugin install intercom-help-center@claude-intercom-help-center
 ```
 
-Pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.1`. From a shell: `claude plugin marketplace add ...` and `claude plugin install ...` work the same way.
+No GitHub SSH key? Use the HTTPS URL instead:
+
+```text
+/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git
+```
+
+Pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.2`. From a shell: `claude plugin marketplace add ...` and `claude plugin install ...` work the same way.
 
 **Windows:** if `marketplace add` fails with "SSH/HTTPS authentication failed" or "Filename too long", git hit Windows' 260-character path limit while cloning (the auth message is misleading). Run `git config --global core.longpaths true` once, then retry.
 

docs/SETUP.md

@@ -23,9 +23,15 @@ In Claude Code, from any folder:
 /plugin install intercom-help-center@claude-intercom-help-center
 ```
 
+No GitHub SSH key? Use the HTTPS URL instead:
+
+```text
+/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git
+```
+
 What you see: `/plugin install` opens the plugin's details in the `/plugin` panel; choose install (user scope is fine). Check it loaded with `/plugin` (it lists 6 skills, 3 agents, 3 hooks) or `claude plugin details intercom-help-center` in a shell.
 
-To pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.1`.
+To pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.2`.
 
 **If the install fails on Windows** with "SSH/HTTPS authentication failed" or "Filename too long": the real cause is git refusing a checkout path longer than Windows' 260-character limit, not your credentials. Run this once, then run the two commands again:
 

docs/TROUBLESHOOTING.md

@@ -18,6 +18,7 @@ Set `HELP_CENTER_DEBUG=1` to also print the stack trace of an unexpected error.
 | The audit says every feature is uncovered | The features have no `label`, `keywords` or `strings` that appear in your articles | Add them to the manifest (see docs/CONFIG.md) |
 | Orphans that are clearly about a real feature | Same cause: the feature's words do not appear in the article | Add `keywords`/`strings` to that feature, or map the file with an `article:` cell |
 | Windows: `/plugin marketplace add` fails with "SSH/HTTPS authentication failed" or "Filename too long" | git hit Windows' 260-character path limit while cloning into Claude Code's plugin folder; the authentication message is misleading | `git config --global core.longpaths true`, then retry the install |
+| `/plugin marketplace add` fails with "SSH authentication failed" or "Permission denied (publickey)" | The `owner/repo` shorthand clones over SSH, and this machine has no SSH key registered with GitHub | Use the HTTPS URL: `/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git`. Or register an SSH key with GitHub (for example with `gh auth login` and SSH as the protocol) |
 | `gh` works in your terminal but not for Claude | Claude Code started from a different shell or environment | Start `claude` from the terminal where `gh auth status` works |
 | Setup finds no strings | Your strings live in an unusual place or format | Pass `--strings path1,path2`; supported: JSON, YAML, .po, .strings, Android XML |
 

templates/github/help-center-audit.yml

@@ -29,7 +29,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer
-          ref: v3.0.1
+          ref: v3.0.2
           path: .help-center-tool
 
       - uses: actions/setup-node@v4

templates/github/help-center-draft-fixes.yml

@@ -52,7 +52,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer
-          ref: v3.0.1
+          ref: v3.0.2
           path: .help-center-tool
 
       - uses: actions/setup-node@v4

templates/github/help-center-gate.yml

@@ -28,7 +28,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer
-          ref: v3.0.1
+          ref: v3.0.2
           path: .help-center-tool
 
       - uses: actions/setup-node@v4