Efaimo
Skill efaimo-ai/efaimo
Audit what your agent loads: quality and context cost for MCP servers and Agent Skills
npx -y skills add efaimo-ai/efaimoAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 21 days oldThe repository was created 21 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Audit MCP servers and Agent Skills for quality and context-window cost. Use when the user wants to check an MCP server's token cost, lint a skill, verify 2026-07-28 MCP spec readiness, or add an efaimo badge or CI gate.
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.6 KB, 627 tokens by cl100k_base, as published. Nobody here has run it
efaimo
efaimo audits what an agent loads: the quality and context-window cost of MCP servers and Agent Skills. Reach for it when someone asks "how many tokens does this MCP server cost", "is my server ready for the 2026-07-28 MCP spec", "is this skill well-formed", or "add a CI gate / badge for context cost".
Commands
Run via npx efaimo (no install needed).
- Weigh context cost of an MCP server
npx efaimo weigh "npx -y <server-package>"for a stdio server, ornpx efaimo weigh https://host/mcpfor a remote one. Add--jsonfor machine output,--badge badge.svgfor a shields badge,--anthropicfor Claude-exact token counts. - Weigh a skill or skill set
npx efaimo weigh ./path/to/skillreports the metadata / body / referenced-file token split. - Weigh everything a client loads
npx efaimo weigh --client claude-code(alsoclaude-desktop,cursor,vscode) sums every configured server. - Audit an MCP server
npx efaimo check --mcp "npx -y <server>"prints a quality grade plus a separate 2026-07-28 migration diff (what breaks under the stateless spec and how to fix it). Add--repo ./srcto also scan source for deprecated primitives,--strictto fail on warnings. - Lint a skill
npx efaimo check --skill ./skills/validates frontmatter, trigger quality, context budget, file references, and injection patterns. - Gate a pull request on context cost
Save a baseline with
npx efaimo weigh "<server>" --out base.json, then in CI runnpx efaimo weigh "<server>" --diff base.json --allow-increase 10to fail when the tool-definition budget grows more than 10 percent.
Reading the output
Findings carry a stable rule id (E1xx MCP readiness, E12x-E13x MCP quality, S1xx
skills) and a severity. The letter grade covers quality and skill findings only;
2026-07-28 readiness items appear separately as an ungraded migration diff. Token
numbers are o200k estimates unless --anthropic is used; see the methodology doc
for the full method.
Notes
efaimo is a linter and cost profiler, not a security scanner: its injection checks are surface heuristics. For supply-chain security use a dedicated scanner. Full rule reference: https://github.com/efaimo-ai/efaimo/blob/main/docs/RULES.md
What ships with it: 103 files
1081.9 KB alongside SKILL.md, 60 of them executable
assets/
- architecture.png101.7 KB
- architecture.svg3.8 KB
- badge-grade.svg723 B
- badge-weigh.svg753 B
- banner.png45.6 KB
- banner.svg1.2 KB
- check.png223.6 KB
- check.svg3.4 KB
- demo.png157.8 KB
- demo.svg2.8 KB
- logo.png13.3 KB
- logo.svg729 B
- social-preview.png54.0 KB
- social-preview.svg1.3 KB
- test-ab.png82.4 KB
- test-ab.svg3.1 KB
docs/
- INTEGRATIONS.md3.5 KB
- METHODOLOGY.md7.4 KB
- RULES.md7.1 KB
examples/
- scenario.crm.yaml1.1 KB
- scenario.example.yaml662 B
research/
scripts/
- skills-corpus.mjsruns2.4 KB
- skills-index.mjsruns11.2 KB
- spec-drift.mjsruns5.9 KB
- action.yml1.5 KB
- CHANGELOG.md11.4 KB
- CODE_OF_CONDUCT.md407 B
- CONTRIBUTING.md3.0 KB
- .editorconfig188 B
- .env.example402 B
- .gitattributes47 B
- .gitignore604 B
- LICENSE11.1 KB
- NOTICE179 B
- package.json1.8 KB
- pnpm-workspace.yaml32 B
- README.md15.8 KB
63 more files not listed here. See all 103 in the repository.