Skip to content

Stop vendoring the bitrefill skill; install from upstream - #8

Merged
kleczkowski merged 3 commits into
mainfrom
chore/de-vendor-bitrefill-skill
Jun 30, 2026
Merged

Stop vendoring the bitrefill skill; install from upstream#8
kleczkowski merged 3 commits into
mainfrom
chore/de-vendor-bitrefill-skill

Conversation

@kleczkowski

@kleczkowski kleczkowski commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

The repo vendored a full copy of the bitrefill skill (skills/bitrefill/SKILL.md + 10 reference files). qupick never used that skill's own mechanics: its purchase flow calls the Bitrefill MCP tools (mcp__bitrefill__*) directly. Vendoring the skill duplicated content qupick doesn't need and drifts from upstream (Bitrefill ships the skill as a plugin and doesn't support installing it by copying files).

Changes

  • Remove skills/bitrefill/ entirely.
  • Reframe the docs MCP-first: qupick's dependency is the Bitrefill MCP, connected with
    claude mcp add --transport http bitrefill https://api.bitrefill.com/mcp --scope user
    The upstream bitrefill plugin (/plugin install bitrefill@bitrefill-skills, https://github.com/bitrefill/agents) is presented as an optional superset that also bundles the skill.
  • README.md — rewrite "Install the skill", the Bitrefill prerequisite bullet, the line-7 delegation note, and the safeguards pointer (the vendored path is gone; the README's own Safeguards section is self-contained).
  • AGENTS.md — replace the mirrored "pick a path / safeguards / reference table" section (which linked the deleted files) with an MCP-first prerequisite note.
  • skills/qupick/SKILL.md — frontmatter + delegation note + the internal buy-products / search-products references now point at the Bitrefill MCP; the broken ../bitrefill/... links are removed.

Notes

  • No skills/bitrefill references remain in tracked files.
  • Pairs with site: add Get started install/usage section #7 (site "Get started" section), which uses the same MCP-first step 1. Disjoint files — no conflict, either merge order works.

The bitrefill skill ships as an upstream plugin (bitrefill/agents) that
registers both the skill and its eCommerce MCP. Vendoring a copy under
skills/bitrefill/ drifts from upstream and isn't a supported install path.

Remove the vendored skill and point qupick's docs at the plugin install
(/plugin install bitrefill@bitrefill-skills). qupick already requires the
Bitrefill MCP tools, which the plugin provides.
qupick calls the mcp__bitrefill__* tools directly; it never uses the
bitrefill skill's own mechanics. Lead the docs with connecting the
Bitrefill MCP (claude mcp add) and present the upstream plugin as an
optional superset that also bundles the skill.
@augmentcode

augmentcode Bot commented Jun 30, 2026

Copy link
Copy Markdown
🤖 Augment PR Summary

Summary: This PR stops vendoring the Bitrefill skill in-repo and switches the docs to installing Bitrefill from its upstream plugin to avoid drift.

Changes:

  • Deleted the vendored skills/bitrefill/ skill and its reference documentation.
  • Updated README.md to install Bitrefill via the upstream plugin flow and to copy only skills/qupick into .claude/skills/.
  • Adjusted setup/prerequisite language to reference the upstream Bitrefill skill + MCP rather than local vendored files.
  • Simplified AGENTS.md Bitrefill guidance to treat it as an external prerequisite, with upstream/docs pointers and safeguard reminders.
  • Updated skills/qupick/SKILL.md to remove broken relative links to the deleted skill and point readers to the upstream install and safeguards.

Technical Notes: qupick still relies on Bitrefill’s eCommerce MCP (https://api.bitrefill.com/mcp) for purchase-related tools; users will authenticate via OAuth or API key on first use.

🤖 Was this summary useful? React with 👍 or 👎

@augmentcode augmentcode Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 1 suggestion posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

Comment thread README.md Outdated
1. **bitrefill (upstream plugin).** Registers the skill and its eCommerce MCP in one step:

```
/plugin marketplace add bitrefill/agents

@augmentcode augmentcode Bot Jun 30, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

README.md: the /plugin ... / /reload-plugins lines read like Claude Code slash-commands; consider explicitly stating they’re meant to be run inside Claude Code (not a terminal), otherwise operators may try to run them in a shell and hit errors.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 1cb5c44 — the optional plugin step now states the /plugin lines are slash-commands run inside Claude Code, not a shell. The required step (claude mcp add) is already a shell command.

@kleczkowski
kleczkowski merged commit 86f3253 into main Jun 30, 2026
1 check passed
@kleczkowski
kleczkowski deleted the chore/de-vendor-bitrefill-skill branch June 30, 2026 11:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant