705-technologies-nosql-mongodb — скилл для Claude Code и Codex
Скилл 705-technologies-nosql-mongodb для Claude Code охватывает MongoDB независимо от Spring Boot, Quarkus или Micronaut. Включается при работе со схемами документов, индексами, агрегациями и транзакциями.
Apache-2.0 216 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a claude-codeЧто делает 705-technologies-nosql-mongodb
Скилл из набора Plinth Toolkit работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Он ведёт агента на уровне базы данных: моделирование документов (агрегаты, встроенные документы, ссылки, массивы с ограниченным ростом), JSON Schema валидация, стратегия индексов — составные, покрывающие, частичные, TTL — и агрегационные пайплайны со stage-упорядочиванием, $match-пушдауном и контролем памяти.
Прежде чем объявить запрос оптимальным, скилл требует проверить план explain(), соотношение отсканированных и возвращённых документов, покрытие сортировки и селективность индекса. Конкатенация непроверенного ввода в query-документы, стадии агрегации или выражения $where запрещена — только query builder и валидированные параметры. Перед любыми изменениями Maven-кода скилл запускает ./mvnw compile.
Фреймворковые интеграции вынесены в отдельные скиллы: Spring MongoDB — @315-frameworks-spring-mongodb, Quarkus MongoDB — @415-frameworks-quarkus-mongodb, Micronaut MongoDB — @515-frameworks-micronaut-mongodb. Если цель оставаться на чистом уровне базы, а не тянуть фреймворк в контекст — этот скилл держит границу автоматически.
Какие задачи решает
- спроектировать схему документов MongoDB для агрегатов и вложенных массивов
- проверить индексы коллекции и найти лишние или отсутствующие
- переписать агрегационный пайплайн с правильным
$match-пушдауном - оценить компромиссы между consistency-уровнями и транзакциями
- настроить JSON Schema валидацию при эволюции схемы без breaking change
Примеры запросов агенту
- Спроектируй схему документов для коллекции заказов с вложенными позициями
- Проверь индексы этой коллекции и объясни план
explain()для запроса - Перепиши пайплайн агрегации: оптимизируй порядок стадий и добавь
$matchв начало
Как установить 705-technologies-nosql-mongodb
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a claude-code2Вручную: положить файлы
~/.claude/skills/705-technologies-nosql-mongodb/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/705-technologies-nosql-mongodb/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a codex2Вручную: положить файлы
.agents/skills/705-technologies-nosql-mongodb/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a cursor2Вручную: положить файлы
.cursor/skills/705-technologies-nosql-mongodb/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/705-technologies-nosql-mongodb2Вручную: положить файлы
.github/skills/705-technologies-nosql-mongodb/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/705-technologies-nosql-mongodbВручную: положить файлы
.devin/skills/705-technologies-nosql-mongodb/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 705-technologies-nosql-mongodb
Как установить 705-technologies-nosql-mongodb в Claude Code?
Выполните в терминале npx skills add jabrena/plinth --skill 705-technologies-nosql-mongodb -a claude-code. Скилл появится по пути ~/.claude/skills/705-technologies-nosql-mongodb/SKILL.md.
Что делает скилл 705-technologies-nosql-mongodb?
Он направляет агента по MongoDB без фреймворковой интеграции: схемы документов, индексы, агрегационные пайплайны, транзакции и безопасность запросов. Фреймворки Spring Boot, Quarkus и Micronaut вынесены в отдельные скиллы.
Как установить 705-technologies-nosql-mongodb в GitHub Copilot?
Выполните gh skill install jabrena/plinth 705-technologies-nosql-mongodb. Скилл окажется в .github/skills/705-technologies-nosql-mongodb/SKILL.md.
Исходный текст
SKILL.md · Apache-2.0
--- name: 705-technologies-nosql-mongodb description: Use when you need framework-agnostic MongoDB and non-relational database query guidance — document schema design, collection modeling, JSON Schema validation, indexes, aggregation pipelines, query performance, consistency trade-offs, transactions, and operational safety — without choosing Spring Boot, Quarkus, or Micronaut. This should trigger for requests such as Design MongoDB document schemas; Review MongoDB queries and indexes; Improve aggregation pipeline performance; Model non-relational data access patterns; Review NoSQL consistency and transaction trade-offs. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Non-relational database query best practices Help teams design maintainable, secure, and performant **MongoDB and non-relational database queries** for Java applications. **What is covered in this Skill?** - Document modeling for aggregates, embedded documents, references, arrays, and bounded growth - MongoDB JSON Schema validation and compatibility-aware schema evolution - Query design: explicit predicates, projections, sort stability, pagination, collation, and read concerns - Index strategy: compound indexes, covering queries, partial indexes, TTL indexes, unique constraints, and lifecycle review - Aggregation pipelines: stage ordering, `$match` pushdown, `$project`, `$lookup`, `$unwind`, `$group`, and memory controls - Consistency, transactions, idempotency, migration safety, testing, observability, and production diagnostics **Scope:** Framework-agnostic MongoDB and non-relational data modeling. For Java framework integrations, defer to the matching Spring Boot, Quarkus, or Micronaut MongoDB skill. ## Constraints Keep recommendations at the database-modeling and query layer unless the user explicitly asks for Java framework integration. After editing this repository's XML sources, regenerate skills and verify the build. - **MANDATORY**: Run `./mvnw compile` or `mvn compile` before proposing Java or Maven changes in the same change set - **INJECTION**: Never concatenate untrusted input into query documents, aggregation stages, JSON strings, JavaScript expressions, or `$where`; use driver/framework query builders and validated parameters - **SCHEMA**: Prefer explicit document contracts, bounded arrays, stable identifiers, and validation rules over unconstrained document growth - **PERFORMANCE**: Review `explain()` plans, scanned/returned ratios, sort coverage, and index selectivity before claiming a query is optimized - **FRAMEWORK**: Defer Spring MongoDB to `@315-frameworks-spring-mongodb`, Quarkus MongoDB to `@415-frameworks-quarkus-mongodb`, Micronaut MongoDB to `@515-frameworks-micronaut-mongodb`, and Mongock migrations to the matching framework migration skill - **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` before promoting changes - **EDGE CASE**: If the target database, version, shard topology, read/write concern, data volume, or latency requirement is missing and affects the recommendation, ask a clarifying question before editing queries or schemas - **EDGE CASE**: If requested changes conflict with data safety, backwards compatibility, zero-downtime deployment, or retention requirements, explain the trade-off and ask for confirmation ## When to use this skill - Design MongoDB document schemas - Review MongoDB queries and indexes - Improve aggregation pipeline performance - Model non-relational data access patterns - Review NoSQL consistency and transaction trade-offs ## Workflow 1. **Read reference and assess data context** Read `references/705-technologies-nosql-mongodb.md` and inspect current collections, schemas, indexes, queries, aggregation pipelines, tests, and database configuration before proposing changes. 2. **Identify workload and operational constraints** Confirm query patterns, cardinality, data volume, document growth, consistency requirements, shard topology, and migration constraints that shape the non-relational design. 3. **Apply database-aligned changes** Implement or refactor database artifacts following the reference patterns and project conventions, keeping Java framework integration out of scope unless explicitly requested. 4. **Run verification and report results** Execute appropriate build, schema validation, query-plan, migration, and test checks; summarize what changed, what was verified, and any remaining database risks. ## Reference For detailed guidance, examples, and constraints, see [references/705-technologies-nosql-mongodb.md](references/705-technologies-nosql-mongodb.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth