Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable, packed with executable introspection SQL and a useful error-handling matrix, but it lacks validation checkpoints in the workflow and fails to surface the bundled scripts, leaving inline content that overlaps with existing bundle files.
Suggestions
Add validation checkpoints to the workflow, e.g. after connecting verify access to information_schema/pg_catalog, and after each extraction confirm non-empty results before generating Markdown.
Replace or supplement the inline ERD/statistics steps with references to the bundled scripts (e.g. 'Run scripts/erd_generator.py --format all for diagrams; see scripts/README.md'), so SKILL.md points to rather than duplicates the bundle.
Trim the narrative Examples and redundant Output section to keep the body lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense and efficient (concrete SQL queries, tight prerequisites), but the narrative Examples section and the Output section—which restates what the instructions already produce—could be tightened to earn a 3. | 2 / 3 |
Actionability | It provides fully executable, copy-paste-ready PostgreSQL and MySQL introspection queries for every step (tables, columns, constraints, foreign keys, indexes, views, routines, statistics), with specific column lists and ordering. | 3 / 3 |
Workflow Clarity | Steps are clearly numbered 1–10, but for a database batch operation there are no validation/verification checkpoints (e.g. confirm connection, verify non-empty results) and no validate→fix→retry feedback loop, which caps workflow clarity at 2 per the database-operations guideline. | 2 / 3 |
Progressive Disclosure | The body is well-sectioned, but it never references the bundled scripts (init_db_docs.py, validate_config.py, erd_generator.py) that already implement related work such as ERD generation; content that could live in those scripts is duplicated inline, so references are neither signaled nor appropriately split. | 2 / 3 |
Total | 9 / 12 Passed |