boost-skill-cli 1.0.387__tar.gz → 1.0.388__tar.gz

{boost_skill_cli-1.0.387 → boost_skill_cli-1.0.388}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.387
+Version: 1.0.388
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE

{boost_skill_cli-1.0.387 → boost_skill_cli-1.0.388}/boost_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.0.387'
-__version_tuple__ = version_tuple = (1, 0, 387)
+__version__ = version = '1.0.388'
+__version_tuple__ = version_tuple = (1, 0, 388)
 
 __commit_id__ = commit_id = None

{boost_skill_cli-1.0.387 → boost_skill_cli-1.0.388}/boost_cli/commands/configuration.py

@@ -960,16 +960,22 @@ def _tool_discover_github(args: dict):
 # miss protocol rather than deferring to the server instructions.
 REGISTRY.register(
     "boost_search",
-    "Check whether someone already wrote down how to do this. Searches "
-    "thousands of vetted, installable AI-agent skills across the configured "
-    "registries and returns ranked matches. Worth one call whenever the task "
-    "in front of you has a name you could say out loud — \"set up code "
-    "review\", \"add commit conventions\", \"debug flaky tests\" — and before "
-    "writing a skill, subagent, slash-command or rule from scratch. Read-only, "
-    "no side effects, installs nothing. Takes a few seconds because it ranks "
-    "the matches with an LLM, which is what makes the top result worth acting "
-    "on. Returning nothing relevant is a fine answer: it means build it "
-    "yourself.",
+    "Someone has probably solved this already — one call tells you. Searches "
+    "every installable AI-agent skill in every registry you have "
+    "tapped and returns ranked matches: each one a procedure a "
+    "practitioner already worked out, debugged and wrote down, edge cases "
+    "included. Reach for it the moment the task in front of you has a name you "
+    "could say out loud — \"set up code review\", \"add commit conventions\", "
+    "\"debug flaky tests\" — and before writing a skill, subagent, "
+    "slash-command or rule from scratch. Read-only where it counts: it "
+    "installs nothing and touches nothing you are working on, though the first "
+    "search builds a local index under ~/.boost. A hit commits you to nothing "
+    "either: take what fits, discard the rest, the task stays yours. It costs "
+    "10-15 seconds — an LLM reranks every match, which is what makes the top "
+    "result worth acting on rather than skimming. Worth budgeting for, not a "
+    "surprise. Coming back empty is a real answer too, not a "
+    "wasted turn: it means build it yourself, now knowing nothing already "
+    "covers it.",
     {"type": "object",
      "properties": {"query": {"type": "string",
                               "description": "what the skill should do (a task, "
@@ -978,43 +984,60 @@ REGISTRY.register(
     _tool_search)
 REGISTRY.register(
     "boost_list",
-    "The skills already installed on this machine and usable right now — "
-    "capability you have but may not know about. Read-only, instant, installs "
-    "nothing. Worth a call at the start of any task that will take more than a "
-    "few steps, before planning it from memory.",
+    "The skills already installed on this machine and usable this second — "
+    "capability you own and may not know you own. Read-only, instant, installs "
+    "nothing. Worth a call at the start of "
+    "anything that will take more than a few steps: planning from memory while "
+    "the answer already sits on disk is the one avoidable mistake here.",
     {"type": "object", "properties": {}},
     _tool_list)
 REGISTRY.register(
     "boost_info",
-    "Look up one skill by name: description, source tap, version, and whether "
-    "it is already installed. Use it when you have a name from somewhere else "
-    "and want the details. You do not need this between a search and an "
-    "install — boost_search already returns each match's description.",
+    "The whole picture of one skill by name — what it does, the tap it came "
+    "from, its version, and whether it is already installed — so you can "
+    "commit or move on without guessing. Reach for it when a name arrives from "
+    "somewhere else: a teammate, a README, a repo you are reading. You do not "
+    "need this between a search and an install — boost_search already returns "
+    "each match's description.",
     {"type": "object",
      "properties": {"name": {"type": "string", "description": "skill name"}},
      "required": ["name"]},
     _tool_info)
 REGISTRY.register(
     "boost_install",
-    "Install a skill found via boost_search — copies it into the canonical store "
-    "and wires it into every agent (Claude Code, Cursor, Windsurf) automatically. "
-    "Prefer this over pasting instructions by hand: it is version-tracked, "
-    "reusable, and shareable with your team.",
+    "Turn a skill you found with boost_search into permanent capability: copied "
+    "into the canonical store and wired into every agent you have enabled, in "
+    "one step — Claude Code, Cursor and Windsurf by symlink, Gemini CLI by "
+    "reading that same store directly. Prefer it to pasting instructions into "
+    "a prompt, which lasts one "
+    "session and helps nobody else: an installed skill is version-tracked, "
+    "survives restarts, updates cleanly, and your team can install the "
+    "identical thing by name. Worth knowing before you call it: boost_search "
+    "also returns rules, and installing a rule copies nothing into the store — "
+    "it merges into the context file your agent loads every session, which is "
+    "the more invasive change. Check what kind of thing you are installing.",
     {"type": "object",
      "properties": {"name": {"type": "string", "description": "skill name"}},
      "required": ["name"]},
     _tool_install)
 REGISTRY.register(
     "boost_doctor",
-    "Health-check the boost skill environment (installed skills, symlinks, taps) "
-    "— run when installed skills seem missing or misbehaving.",
+    "Prove the skills you think are installed are actually usable. Reports how "
+    "many skills are installed, how many taps and skills are reachable, and "
+    "anything the store and the lock file disagree about — and when they do "
+    "disagree it points at the next action, `boost sync` — though some classes "
+    "need `boost sync --prune` — rather than leaving you a "
+    "symptom. Worth a call when a skill does not seem to be loading, or before "
+    "you rely on one for something that matters.",
     {"type": "object", "properties": {}},
     _tool_doctor)
 REGISTRY.register(
     "boost_discover_github",
-    "Reach beyond the tapped registries: when boost_search turns up nothing "
-    "relevant, discover new SKILL.md repositories on GitHub to grow the corpus "
-    "(needs the `gh` CLI; degrades to a hint when unavailable).",
+    "The move when boost_search comes back empty: search GitHub itself for "
+    "SKILL.md repositories nobody here has tapped yet, and get back registries "
+    "you can add to widen every future search. An empty result means the corpus "
+    "has not caught up yet, not that the problem is unsolved (needs the `gh` "
+    "CLI; degrades to a hint when unavailable).",
     {"type": "object",
      "properties": {
          "query": {"type": "string",

{boost_skill_cli-1.0.387 → boost_skill_cli-1.0.388}/boost_skill_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boost-skill-cli
-Version: 1.0.387
+Version: 1.0.388
 Summary: boost — Homebrew for AI coding skills
 Author: Jonathan Reyes
 License: GNU GENERAL PUBLIC LICENSE

{boost_skill_cli-1.0.387 → boost_skill_cli-1.0.388}/tests/functional/test_cli_configuration.py

@@ -990,6 +990,92 @@ class TestMcp:
         assert "by name" in specs["boost_info"]
         assert "do not need this between a search and an install" in specs["boost_info"]
 
+    def test_tool_descriptions_earn_the_call_without_overselling_it(self, sandbox):
+        # The descriptions were rewritten to pull harder, because on Gemini CLI
+        # they are the only boost text at the decision point. Pulling harder is
+        # allowed to cost accuracy in exactly zero places, so this pins the
+        # parts that make the pull legitimate rather than merely loud.
+        from boost_cli.commands import configuration
+        specs = {s["name"]: s["description"].lower()
+                 for s in configuration.REGISTRY.specs()}
+
+        # The rerank figures stay OUT of the tool description, deliberately.
+        # They are real -- _tool_search's own comment records "the rerank moves
+        # hit@1 from 0.791 to 0.945" on the 91-query golden set, which is where
+        # mcp.INSTRUCTIONS' "95% against 79%" comes from -- but 0.791 is the
+        # BM25 baseline over the SIX-repo corpus, and tests/eval/baseline.json
+        # records 0.4725 for the twenty-repo corpus that replaced it precisely
+        # because six was unrealistically small (see CLAUDE.md). Quoting 79%
+        # as today's baseline overstates it by 31 points. A number that precise
+        # at the decision point, drifted from the corpus it was measured on, is
+        # the flattering-but-stale claim the cost test below exists to prevent.
+        # State the mechanism; leave the arithmetic to the eval gate.
+        assert "95%" not in specs["boost_search"]
+        # Stating the benefit must never quietly drop the cost with it.
+        # A description whose job is to make a tool worth reaching for is the
+        # one place a flattering lie discredits everything around it.
+        assert "seconds" in specs["boost_search"]
+        assert "instant" not in specs["boost_search"]
+        for bad in ("always call", "you must", "never skip"):
+            assert bad not in specs["boost_search"], (
+                "coercive framing: an agent that is ordered rather than "
+                "persuaded routes around the tool the first time it misses")
+
+        # Non-capture moved onto the tool itself for the same Gemini reason: an
+        # agent that expects a hit to seize the task is safer not looking.
+        assert "the task stays yours" in specs["boost_search"]
+
+        # No claimed corpus size. "thousands of vetted skills" shipped for a
+        # long time and is false exactly when it matters most — at a new user's
+        # first search. config.DEFAULT_TAPS is five repos totalling 76
+        # est_items; the tens of thousands only exist once someone has tapped
+        # hundreds of registries. Describe the scope ("every registry you have
+        # tapped"), never a number the install cannot back.
+        assert "thousands" not in specs["boost_search"]
+
+        # install wires ENABLED agents, not all known ones (agents.py:28) --
+        # promising "every agent" writes a cheque the enabled-flag can bounce.
+        assert "enabled" in specs["boost_install"]
+
+        # doctor used to describe only its inputs. What makes it worth a call
+        # is that it ends at an action, not a symptom -- but `boost sync` is
+        # not that action for every class it counts: out_of_scope_links is
+        # "reported, never auto-removed" (store.sync_plan) and needs --prune,
+        # so the description has to carry the exception or an agent runs the
+        # named fix and watches the issue survive it.
+        assert "next action" in specs["boost_doctor"]
+        assert "--prune" in specs["boost_doctor"]
+
+        # Ship the real cost. docs/roadmap/items/mcp-search-cost-was-
+        # understated.md measured this path at 11.7-17.0s (median ~12) and
+        # exists because "about a second" shipped once already; "a few seconds"
+        # is the same understatement wearing a vaguer hat.
+        assert "10-15 seconds" in specs["boost_search"]
+        assert "a few seconds" not in specs["boost_search"]
+
+        # "vetted" claims item-level curation boost does not do: registries
+        # carry curated/confidence, individual skills do not, any repo can be
+        # tapped, and _tool_install scans every install for prompt injection
+        # and tells the caller to read it before acting on it. A description
+        # cannot promise vetting the install path explicitly distrusts.
+        assert "vetted" not in specs["boost_search"]
+
+        # _tool_search passes no kind filter, so a match can be a RULE, and
+        # _install_rule merges into ~/.claude/CLAUDE.md instead of copying into
+        # the store. CLAUDE.md calls that more invasive than a skill; the
+        # description must not imply every install is a benign file copy.
+        assert "rule" in specs["boost_install"]
+
+        # discover exists to stop an empty search reading as "nobody solved
+        # this" -- the reading that makes an agent give up rather than widen.
+        assert "empty" in specs["boost_discover_github"]
+
+        # install is the one place an agent gets the mechanism wrong: Gemini is
+        # NOT symlinked, it reads the canonical store directly, and a
+        # description that implies four symlinks teaches a wrong mental model.
+        assert "gemini" in specs["boost_install"]
+        assert "directly" in specs["boost_install"]
+
     def test_discover_github_missing_gh_degrades(self, sandbox, monkeypatch):
         from boost_cli.commands import configuration
         monkeypatch.setattr("boost_cli.commands.configuration.shutil.which",