CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mongodb-expert

Use when working with MongoDB — designing a schema or collection (embed vs reference, data modeling, BSON types, schema validation), optimizing performance (indexes, ESR rule, explain() / slow query tuning, aggregation pipelines, covered queries), benchmarking or monitoring (profiler, mongostat, working set, executionStats), or applying standard practices (write/read concern, read preference, transactions, replication, sharding/shard keys, security, connection pooling). Covers MongoDB 8.0 with version-gated notes back to 4.x.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured reference-skill overview: lean quick-reference rules, an excellent task-to-file routing table, and clean one-level progressive disclosure into four real bundle files. The main costs are the runtime-irrelevant maintenance section and rule statements whose executable detail lives entirely in the references.

Suggestions

Move the 'Keeping this skill current' maintenance procedure into a separate file (e.g., references/maintenance.md or MAINTENANCE.md) and keep a one-line pointer in SKILL.md, reclaiming ~12 lines of token budget for answer-time context.

Add one or two short executable snippets to the quick-reference rules (e.g., the createIndex + explain("executionStats") pair for the ESR heuristic) so the highest-leverage rules are directly actionable without loading a reference file.

Delete the forward-reference line 'MongoDB ships a major release roughly yearly. See [Keeping this skill current]…' — it duplicates the section that follows it.

DimensionReasoningScore

Conciseness

The body is dense and rule-driven ('Hard limit: 16 MB per document', 'Order compound index keys by ESR') with no concept tutorials, but the 12-line 'Keeping this skill current' maintenance section and the forward-reference line 'MongoDB ships a major release roughly yearly. See [Keeping this skill current]…' are maintenance-time rather than answer-time content — minor over-explanation that could be trimmed, so anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete, specific guidance throughout: the executable diagnostic heuristic 'nReturned ≈ totalKeysExamined ≈ totalDocsExamined', the copy-pasteable command 'grep -rn "(≥" ~/.claude/skills/mongodb-expert/', and precise defaults ('default chunk size 128 MB since 5.2', 'w:"majority" is the 8.0 default (≥5.0)'). Most rules are assertions whose executable detail is deferred to the reference files, matching anchor 4's 'minor gaps' rather than anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The routing table ('Which reference to load') gives an unambiguous task/symptom → file decision procedure, and the maintenance procedure is a numbered 5-step sequence with checking built into steps 2–4. Validation checkpoints are otherwise implicit (e.g., 'aim for explain("executionStats")' is a check described, not an enforced step), so anchor 4's 'most checkpoints present; minor validation gaps' fits better than anchor 5.

4 / 5

Progressive Disclosure

A clear overview with four one-level-deep references (references/schema-design.md, performance.md, benchmarking.md, standard-practices.md — all verified to exist), each mapped from concrete task/symptom rows in a routing table, with quick rules inline and detail appropriately split out. This matches the anchor-5 example structure of well-signaled one-level-deep references with easy navigation.

5 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: third-person, dense with concrete capabilities and natural trigger phrases, explicit 'Use when' guidance covering all four task areas, and a clear MongoDB 8.0 scope statement. It reads as trigger phrases rather than padded prose, so verbosity is not an issue despite its length.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions across four capability areas — 'designing a schema or collection (embed vs reference, data modeling, BSON types, schema validation)', 'optimizing performance (indexes, ESR rule, explain() / slow query tuning, aggregation pipelines, covered queries)', 'benchmarking or monitoring (profiler, mongostat, working set, executionStats)' — with no coverage gaps, matching the comprehensive anchor rather than the 'minor gaps' anchor 4.

5 / 5

Completeness

Explicitly answers 'when' with 'Use when working with MongoDB —' followed by four concrete trigger scenarios, and 'what' via the enumerated actions and 'Covers MongoDB 8.0 with version-gated notes back to 4.x'. Both are explicit with concrete trigger phrases, matching the anchor-5 example structure; it does not fall to anchor 4 since the 'when' is highly specific, not merely present.

5 / 5

Trigger Term Quality

Comprehensive natural terms users would actually say: 'MongoDB', 'schema', 'slow query', 'indexes', 'aggregation pipelines', 'sharding', 'replication', 'transactions', 'profiler', plus synonyms ('data modeling', 'monitoring', 'embed vs reference'). Anchor 4 would require missing natural terms, and none of the common MongoDB task phrases are absent.

5 / 5

Distinctiveness Conflict Risk

A clear niche ('MongoDB') with distinctive triggers such as 'ESR rule', 'mongostat', 'shard keys', and 'write/read concern' that no generic or adjacent skill would claim — minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

sayed-moin-ahmed/mongodb-expert-skill

Path

SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.