mongodb
Guide for implementing MongoDB - a document database platform with CRUD operations, aggregation pipelines, indexing, replication, sharding, search capabilities, and comprehensive security. Use when working with MongoDB databases, designing schemas, writing queries, optimizing performance, configuring deployments (Atlas/self-managed/Kubernetes), implementing security, or integrating with applications through 15+ official drivers. (project)
53
Quality
42%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./claude/skills/mongodb/SKILL.mdQuality
Discovery
N/ABased on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
Something went wrong
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides comprehensive, actionable MongoDB coverage with excellent executable code examples across multiple languages. However, it severely violates token efficiency by including ~1500 lines of content that could be condensed to ~300 lines of essential patterns with references to detailed sub-files. The lack of progressive disclosure and validation checkpoints in workflows limits its effectiveness as a quick-reference skill.
Suggestions
Reduce content by 70%+ by removing explanatory text Claude already knows (e.g., what replica sets are, what sharding does) and keeping only the code patterns and commands
Split into multiple files: SKILL.md (overview + quick reference), CRUD.md, AGGREGATION.md, INDEXING.md, DEPLOYMENT.md, SECURITY.md with clear navigation links
Add explicit validation steps to multi-step workflows (e.g., 'After enabling sharding, verify with sh.status()', 'After replica set init, confirm with rs.status() showing all members')
Remove the 'When to Use This Skill' and 'Documentation Coverage' sections entirely - they provide no actionable guidance
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~1500+ lines. Includes extensive explanations Claude already knows (what replica sets are, what sharding is, basic CRUD concepts). The 'When to Use This Skill' and 'Documentation Coverage' sections add no actionable value. Much content could be condensed by 70%+. | 1 / 3 |
Actionability | Excellent executable code examples throughout - all JavaScript/Python/Java/Go snippets are copy-paste ready with proper syntax. Concrete commands for installation, configuration, and operations. Examples cover real-world patterns like pagination, atomic counters, and bulk operations. | 3 / 3 |
Workflow Clarity | Individual operations are clear, but multi-step processes lack explicit validation checkpoints. For example, sharding setup doesn't include verification steps, transaction example lacks error handling guidance beyond basic try/catch, and deployment sections don't specify how to verify successful configuration. | 2 / 3 |
Progressive Disclosure | Monolithic wall of text with 14 major sections all inline. No references to external files for detailed content. The 'Resources' section at the end links to external docs but the skill itself should split content like driver examples, deployment configs, and troubleshooting into separate referenced files. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (1425 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
- Repository
- einverne/dotfiles
- Commit
b1b2fe0
- 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.