ID

intel/dokimi

Developer tools
10 stars Quality 66 Trend 38Apache-2.0

Dokimi (Greek δοκιμή, "test, proof") measures whether a skill, MCP doc source, agent profile or repository guidance actually helps a coding agent: paired on/off arm comparisons, novel-vs-known...

Overview

Skills, instructions, docs, MCP servers and a repository's AGENTS.md are cheap to write and easy to over-claim. Dokimi runs the same questions or coding tasks with and without one change, grades both the same way, and reports the difference with its p-value, per model. Then it shows which parts of a skill the model already knew, which it added and which it broke, and proposes a shorter version that keeps what matters. — Greek δοκιμή, "test, proof". An artifact gets trusted because it passed a test that could have failed, not because it is popular. Dokimi asks the model about each claim in a skill twice, without the skill and with it, and a different model grades both answers.

README

Dokimi — A/B testing for agent context

Proof, not popularity: find out whether your agent’s skills, docs and AGENTS.md actually work.

**Documentation: ** — the full tour, with every figure.

What it is

Skills, instructions, docs, MCP servers and a repository’s AGENTS.md are cheap to write and easy to over-claim. Dokimi runs the same questions or coding tasks with and without one change, grades both the same way, and reports the difference with its p-value, per model. Then it shows which parts of a skill the model already knew, which it added and which it broke, and proposes a shorter version that keeps what matters.

dokimi — Greek δοκιμή, “test, proof”. An artifact gets trusted because it passed a test that could have failed, not because it is popular.

Which parts help: novelty. Dokimi asks the model about each claim in a skill twice, without the skill and with it, and a different model grades both answers. Every claim lands in one of four outcomes (more):

What measuring shows so far (evidence): under lenient grading, 70% of what a skill says a frontier model already produces unprompted; under strict grading, which also checks exact values, 38% is still missing even with the skill in context; a plausible wrong value planted in a skill is repeated in 85–94% of cases in a small study; and what a small model needs, a large one may not, so every verdict is per model.

Start here

cd dokimi && pip install -e .     # installs the `dokimi` command
You want to… Start with Then read
Check a skill dokimi catalog scan --root --kind skills (free) Reviewing a skill
Check a repository’s agent setup dokimi repo scan (free) Reviewing a repository
See which parts of a skill help dokimi novelty analyze --artifact skill: --tier triage --estimate-only (free estimate) Content novelty
Compare with and without a change dokimi arms run --arms baseline,skill: … Evaluating treatments
Write evals you can trust the dokimi-design-evals skill External content

Every step lists its cost; the free ones come first.

Coding agents. Asked to “use dokimi to review this skill” or “this repository’s agent setup”? Follow reviewing.md step by step: it says which command to run, what each costs, and how to read the result. dokimi --help lists every command. To change dokimi itself, read AGENTS.md.

More: what Dokimi measures · why it exists · contributing · CLI reference

License

Licensed under the Apache License, Version 2.0; see NOTICE for attribution.

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add intel/dokimi
New to MCP? Start with the mcpskill.org guide →