Content
15%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.
The body is a brochure, not an instruction document: it enumerates capabilities and safety claims but provides zero executable commands, SQL, or ordered procedures for any of the seven advertised task categories. For a skill covering destructive database operations, the absence of any step sequence or validation loop is the most serious deficiency.
Suggestions
Replace the capability bullets with at least one executable workflow per task category — e.g. concrete connectivity test (mysql -h host -u user -p -e 'SELECT 1' or PHP PDO snippet), a migration command, and an EXPLAIN-based slow-query check.
Define an ordered, validated procedure for destructive operations: backup (mysqldump ...), verify the backup, apply the change in staging, validate, then promote to production with a rollback path — making the "Safety Features" claims actionable.
Move the five example prompts and per-task detail into one-level-deep reference files (e.g. references/connection-issues.md, references/security.md) so SKILL.md is a lean overview with clearly signaled links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded promotional material — a "What This Skill Does" bullet catalog, a "Safety Features" marketing list, five example-prompt blocks, and an "Output" section describing reports it will "provide" — all of which is noticeably verbose with no instructional payload. Not 3 because almost none of the ~83 lines add knowledge Claude does not already have; not 1 because there is no conceptual explanation of MySQL/PHP basics, just filler. | 2 / 5 |
Actionability | There is no concrete command, SQL snippet, diagnostic step, or code anywhere in the body; it only describes ("Test remote MySQL connectivity", "Always creates database backups before modifications") rather than instructs, matching the anchor for entirely vague content with no concrete guidance. Not 2 because even high-level step hints for executing any task are absent — the closest thing to guidance is the "@mysql-php-fixer" invocation line. | 1 / 5 |
Workflow Clarity | No sequenced workflow exists — the "Safety Features" section lists practices (backup first, validate in staging, rollback support) as assertions, with no ordered steps and no validation checkpoints for database operations, which the rubric caps at 3 anyway. Not 2 because there is not even a rough sequence of steps to follow; the steps are missing entirely. | 1 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers and no nested references (there are no bundle files at all), but everything — the five task examples, requirements, and per-category guidance — is inlined in SKILL.md when categories like connection troubleshooting and security fixes belong in one-level-deep reference files. Not 4 because content that clearly should be split out is inline; not 2 because it is not a monolithic wall of text — the section structure is legible. | 3 / 5 |
Total | 7 / 20 Passed |