mcpField
P
platform-database

platform-database

github.com/ravnhqData & databases1640 installsUpdated 21w ago
Repository

About platform-database

platform-database is a skill for database-related tasks. It helps agents identify when its guidance applies, follow the referenced rules, and validate actionable results, with schema and migration reviews as an example.

Key features

  1. 01Identify database-task triggers
  2. 02Apply guidance from the rules index
  3. 03Follow the workflow and validate results

Use cases

  1. 01Review a database schema and migration plan
  2. 02Troubleshoot missed triggers or conflicting guidance

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ravnhq/ai-toolkit --skill platform-database

After installing, type/platform-databasein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

rules/
_sections.md
index-concurrent-creation.md
index-covering-queries.md
index-foreign-keys.md
migration-add-columns-safely.md
migration-forward-only.md
migration-one-change.md
migration-review-generated-sql.md
migration-separate-data-schema.md
query-avoid-functions-on-indexed.md
query-avoid-leading-wildcards.md
query-filter-early.md
query-n-plus-one.md
query-prefer-exists-over-in.md
query-select-columns.md
query-use-explain.md
schema-timestamps.md
schema-use-appropriate-types.md
transaction-keep-short.md
transaction-wrap-related-mutations.md

Details

From the project README

Principles

  • Prefer UNION ALL over UNION unless you specifically need deduplication

Rules

See rules index for detailed patterns.

Examples

Positive Trigger

User: "Review this schema and migration plan for zero-downtime rollout."

Expected behavior: Use platform-database guidance, follow its workflow, and return actionable output.

Non-Trigger

User: "Implement ARIA labels and focus rings on this modal."

Expected behavior: Do not prioritize platform-database; choose a more relevant skill or proceed without it.

Troubleshooting

Skill Does Not Trigger
  • Error: The skill is not selected when expected.
  • Cause: Request wording does not clearly match the description trigger conditions.
  • Solution: Rephrase with explicit domain/task keywords from the description and retry.
Guidance Conflicts With Another Skill
  • Error: Instructions from multiple skills conflict in one task.
  • Cause: Overlapping scope across loaded skills.
  • Solution: State which skill is authoritative for the current step and apply that workflow first.
Output Is Too Generic
  • Error: Result lacks concrete, actionable detail.
  • Cause: Task input omitted context, constraints, or target format.
  • Solution: Add specific constraints (environment, scope, format, success criteria) and rerun.

Workflow

  1. Identify whether the request clearly matches platform-database scope and triggers.
  2. Apply the skill rules and referenced guidance to produce a concrete result.
  3. Validate output quality against constraints; if gaps remain, refine once with explicit assumptions.

Comments

Markdown supported