Skip to content

Make MCP the default path and demote CLI to optional in skills - #29

Open
jeffrey-ng wants to merge 1 commit into
mainfrom
jeff/soften-cli-emphasis-in-skills
Open

Make MCP the default path and demote CLI to optional in skills#29
jeffrey-ng wants to merge 1 commit into
mainfrom
jeff/soften-cli-emphasis-in-skills

Conversation

@jeffrey-ng

Copy link
Copy Markdown
Contributor

Summary

  • Rebalance every Unblocked skill's "How to Invoke" so the context_research / context_get_urls (MCP) call reads as the normal first-class path, with the CLI demoted to an optional enhancement — reversing commit Make Unblocked CLI availability unmissable in skills #22's "CLI preferred / MCP fallback" framing that made agents announce "CLI is not installed, using the MCP fallback" in MCP-only environments like the desktop app.
  • Remove the command -v unblocked per-session probing and the alarmist "MCP surface tells you nothing" / "single most common failure mode" framing from unblocked-tools-guide; replace with calmer "What's Available Where" + "Default to MCP" guidance.
  • Preserve the real distinctions: fine-grained context_search_*/context_query_* tools remain CLI-only, and the query skills keep the ranked-vs-exhaustive caveat so ranked results aren't passed off as complete.

Commit #22 framed the CLI as preferred and MCP as a degraded "fallback
(only if CLI confirmed unavailable)", and told agents to run
`command -v unblocked` each session. In MCP-only environments (e.g. the
desktop app) this primes the agent to announce "CLI is not installed, so
I'm using the MCP fallback" — noisy and misleading since context_research
works fine there.

Rebalance every skill's "How to Invoke" so the context_research /
context_get_urls call reads as the normal first-class path, with the CLI
presented as an optional enhancement for source-scoped search or
exhaustive enumeration when it happens to be installed. Remove the
command -v unblocked probing and the alarmist "MCP surface tells you
nothing" framing from unblocked-tools-guide.

Keeps the genuine facts intact: fine-grained tools are CLI-only, and
context_query_* enumerates while context_research only ranks.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant