skills-marketplace/README.md
Michał Kopeć 576a14c82f Add ivona and timesheet plugins, MIT LICENSE, and invoice-prep-test
Adds ivona (invoice-checker, timesheet-checker) and timesheet
(check-my-timesheet, invoice-prep) as new plugins, plus invoice-prep-test — a
one-off experiment that requests the Tempo API token via plugin userConfig at
install time instead of a .env file, to check whether that value actually
reaches the skill's script. Also adds the root LICENSE (MIT) referenced from
the README.
2026-07-15 15:00:21 +02:00

62 lines
3 KiB
Markdown

# Skills Marketplace
A Claude Code plugin marketplace bundling personal skills for interviews, meetings,
writing, and invoice/timesheet checks. Each skill is packaged as its own installable plugin.
## Plugins
| Plugin | Description |
| --- | --- |
| `ghost-writer` | Rewrite and humanize text to remove AI writing patterns and match your own voice. |
| `hr-manager` | Run mock job interviews and produce a scored assessment with a prioritised learning plan. |
| `interview` | Run a structured interview and save the captured knowledge to a markdown file. |
| `invoice-prep-test` | **Test plugin.** Copy of `invoice-prep` that asks for the Tempo API token via plugin `userConfig` at install time instead of `.env`. |
| `ivona` | Check KSeF invoices against contractors/white-list and audit team timesheet completion via Tempo. |
| `meeting-notes` | Interview a participant about a meeting and produce structured meeting notes. |
| `meeting-prep` | Generate a prioritised list of questions for an upcoming meeting based on wiki knowledge gaps. |
| `quiz` | Quiz the user on knowledge captured in the wiki, with scoring and immediate feedback. |
| `resolve-todos` | Find and resolve TODO items in a document, asking for input when instructions are unclear. |
| `timesheet` | Check and log your own Tempo timesheet, and see what to put on your invoice for a given month. |
## Installing
Add this marketplace locally and install a plugin:
```bash
/plugin marketplace add "/Users/michalkopec/Documents/Projects/Skills Marketplace"
/plugin install ghost-writer@skills-marketplace
```
This marketplace is published at `git.wierzbowa.cloud`. Since that's not GitHub, the
bare `owner/repo` shorthand won't resolve — use the full clone URL instead:
```bash
/plugin marketplace add https://git.wierzbowa.cloud/Cloud_Drift/skills-marketplace.git
```
## Credential setup — under test
Most plugins that call an external API (Tempo, Jira, KSeF) currently read credentials
from a `.env` file the user creates from `.env.example`. `invoice-prep-test` is a
one-off experiment to see whether Claude Code's plugin `userConfig` mechanism — which
prompts for a value at install/enable time and can mark it `sensitive` — actually
reaches a skill's script as an environment variable
(`CLAUDE_PLUGIN_OPTION_TEMPO_API_TOKEN`) when that script runs via the Bash tool.
To test:
```bash
/plugin install invoice-prep-test@skills-marketplace
```
You should be prompted for a "Tempo API Token" during install. Then ask Claude
something like "what should I put on my invoice for last month" and check the
script's printed "Tempo token source" line — it reports whether it used the
plugin-provided value or fell back to `.env`/plain env. Once we know which
mechanism works, we'll standardize the rest of the credential-needing plugins
(`ivona`, `timesheet`) on it.
## Licensing
All plugins (`ghost-writer`, `hr-manager`, `interview`, `ivona`, `meeting-notes`,
`meeting-prep`, `quiz`, `resolve-todos`, `timesheet`) are licensed under the MIT
License — see [LICENSE](LICENSE).