Skip to content

feat(skills): decide — the free typed-judgment endpoint as a skill, not a tool - #152

Merged
VickyXAI merged 3 commits into
mainfrom
feat/decide-skill
Sep 20, 2026
Merged

VickyXAI merged 3 commits into
mainfrom
feat/decide-skill

Conversation

@VickyXAI

Copy link
Copy Markdown
Contributor

What

A decide skill for POST api.blockrun.ai/v1/decide (OpenJev typed judgments), registered in the marketplace, plus the skill count (16 → 17) and a pointer from the blockrun router skill.

Why a skill and not a blockrun_decide tool

  • Every MCP caller is already a frontier model and a better one-off judge than a 4B NLI cross-encoder.
  • The default install is wallet mode with no brk_ key; a tool would mostly return "go register".
  • A tool costs ~600–800 schema tokens per turn for every user; a skill costs nothing until triggered.
  • decide's real audience is programs without a model (SDK/API), which the docs page already serves. The skill exists for the "try it on my data from Claude Code first" case, via curl.

What the skill says that it must say

  • confidence on a choice is a share of agreement found, not a probability the answer is correct (the equal-weak / equal-strong example from the API reference).
  • OpenJev is not Jev: unaffiliated, MIT, AlexWortega, Qwen3.5-4B base; no quality comparison exists and none is quoted.
  • Export the key in the shell; do not write ~/.blockrun/.api-key just to try this, because that file moves every paid tool to account billing.

Verification

  • npm test: 1312/1312 (marketplace reachability, frontmatter YAML, doc-file-refs, skills CLI all cover the new directory).
  • npx tsx src/index.ts skills list shows decide.
  • claude plugin validate . passes (pre-existing warning about a missing marketplace description only).
  • Wire format checked against the live endpoint (401 invalid_api_key with no key) and https://blockrun.ai/docs/api-reference/decide; attribution facts from https://blockrun.ai/openjev.

No source, tool count, schema-token or CHANGELOG changes — nothing to release; the skill ships with the next version.

🤖 Generated with Claude Code

VickyXAI and others added 3 commits September 20, 2026 21:04
…aude Code, without an MCP tool

POST api.blockrun.ai/v1/decide (OpenJev) is free behind a registered key and
not x402. It is deliberately NOT a blockrun_decide tool: every MCP caller is
already a frontier model and a better one-off judge than a 4B NLI
cross-encoder, the default wallet install has no brk_ key, and a tool taxes
every user's context on every turn for an experiment few run. The skill costs
nothing until triggered and carries the whole recipe: curl, the three question
types and their limits, the response shape, and the eval loop over the user's
own labelled rows.

Two things every surface has to say, and this one does: the `confidence` on a
choice is a share of agreement, not a probability (equal-weak and equal-strong
support are indistinguishable after normalisation), and OpenJev is not Jev —
unaffiliated, MIT, no published comparison, none invented.

Also tells the agent to export the key in the shell rather than write
~/.blockrun/.api-key, because that file flips every paid tool to account
billing at the next start.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
…stion at `decide`

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
@VickyXAI
VickyXAI merged commit cdfe831 into main Sep 20, 2026
3 checks passed
@VickyXAI
VickyXAI deleted the feat/decide-skill branch September 20, 2026 12:12
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