sparehand-plugin/ (repo root)
├── .claude-plugin/marketplace.json marketplace file; points to plugin/
├── plugin/ the plugin itself
│ ├── .claude-plugin/ plugin.json, icon.png
│ ├── gemini-extension.json manifest for Gemini CLI
│ ├── skills/
│ │ ├── start/ welcome, skills list, source record,
│ │ │ optional GitHub step and account guide
│ │ ├── partner-event-finder/ SKILL.md router, prompts/, templates/,
│ │ │ references/, scripts/
│ │ ├── install-automation/ SKILL.md, references/catalog.md
│ │ └── share-feedback/ SKILL.md, report format
│ ├── guides/ short how-to pages for staff
│ ├── CHANGELOG.md, CONNECTORS.md
├── docs/ these docs
├── scripts/build_zip.py builds an upload ZIP
├── .github/ CI checks, ISSUE_TEMPLATE/feedback.yml
├── LICENSE, README.md
The marketplace file stays at the repo root so marketplaces can find it; its source is ./plugin. The plugin manifest lives in plugin/.claude-plugin/ because Claude requires that folder. It is one copy, not a copy per tool. Other tools read the same plugin/skills/ folder.
Each skill has a short SKILL.md that routes to numbered prompt files (loaded only when needed) and exact-wording templates.
plugin/.claude-plugin/plugin.json is higher.plugin/CHANGELOG.md.sparehand-plugin/
├── metadata.txt (where the plugin came from; version)
└── partner-event-finder/
└── <project name>/
├── <project name> sources (Google Sheet: Organizations, Sources, Log)
└── metadata.txt (settings; you never need to edit it)
start, partner-event-finder and install-automation count their use anonymously. The first time you open any of them, they show one short note and ask for your organization’s name (once). share-feedback never asks and never sends a count.
What is collected: tool and version, event type, test-or-real flag, organization name as typed (lowercased), a random code, counts, the failing step, the automation chosen, UTC time, a run code, and which AI or app sent it (a category only).
What is never collected: IP address, country, raw user-agent text, names, emails, partner lists, events, or file contents.
Where your identity is saved: in your AI assistant’s memory when it has one, and in the root metadata.txt in your Drive folder sparehand-plugin when Drive is already connected. With a saved identity you are never asked again. If neither is available, you are asked again next time.
A count is sent silently by one short web request, and a failed or blocked request never affects a run. See TERMS.md and PRIVACY.md.
It can only find what partners publish. Facebook and Instagram are not read in this version. It cannot create a calendar for you; the skill shows you how (one minute).