Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced reference for Supabase MCP operations with strong workflow validation and error-recovery guidance. It is held back by duplicated pitfall content and a monolithic single-file structure with no progressive disclosure to separate reference files.
Suggestions
Remove the consolidated 'Known Pitfalls' section (or reduce it to a one-line cross-reference), since the same pitfalls are already covered in each workflow's 'Pitfalls' block — this removes ~40 lines of repetition.
Move the per-tool parameter reference and/or Quick Reference table into a separate referenced file (e.g. references/tools.md) and keep SKILL.md as a concise overview with one-level-deep links to improve progressive disclosure.
Add an explicit post-write verification step in the SQL workflow (e.g. re-query affected rows or check return counts) to strengthen the feedback loop for destructive operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely concrete reference material with no basic-concept padding, but the consolidated 'Known Pitfalls' section repeats pitfalls already stated per-workflow (project_ref format, array syntax, case-sensitive identifiers, ERROR 42P01/42883, API-key handling) and the Quick Reference table re-lists tools, so it could be tightened. | 2 / 3 |
Actionability | Gives concrete, copy-paste-ready guidance: exact tool slugs in numbered sequences, named parameters with types, value patterns ('^[a-z]{20}$'), filter operators, and SQL syntax — specific enough to act on directly. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with [Prerequisite]/[Required]/[Optional] tags, explicit validation checkpoints ('Confirm connection status shows ACTIVE before running any workflows', inspect schemas before writes, read_only:true), and error-code → remediation feedback (ERROR 42P01/42883). | 3 / 3 |
Progressive Disclosure | Well organized into sections, but it is a single ~233-line monolithic file with no bundle files and no one-level-deep references; the detailed parameter reference and Quick Reference table are inline content that could be split out for clearer progressive disclosure. | 2 / 3 |
Total | 10 / 12 Passed |