Content
76%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A comprehensive, highly actionable CLI command reference that is well organized and lean. Its main weakness is the absence of validation/verification guidance around destructive database and project operations, which limits workflow clarity.
Suggestions
Add explicit validation checkpoints before/after destructive commands (e.g., run 'supabase migration list' or '--dry-run' before 'db push'/'db reset', and confirm project-ref before 'projects delete').
Reduce redundancy between the Quick Reference table and the detailed sections, or explicitly note the table is a summary and the sections hold the flags/examples.
Move the bulkier command catalogs (e.g., inspect db, backup/restore) into the reference files so SKILL.md reads more as an overview with signaled deep-dives.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean command reference with minimal concept explanation, but the Quick Reference table duplicates commands restated in later sections, a minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout, including a complete curl test example and concrete flags covering the common cases. | 5 / 5 |
Workflow Clarity | Tasks are organized into sequenced sections, but destructive/batch operations ('db reset', 'migration down', 'stop --no-backup', 'projects delete') lack validation checkpoints or feedback loops, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | Good structure with a clearly signaled one-level-deep References section pointing to three real files (local-development.md, migrations.md, config-toml.md), though a large amount of command detail remains inline rather than split out. | 4 / 5 |
Total | 16 / 20 Passed |