Content
71%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 well-structured, actionable body with a clear sequenced workflow, explicit validation checkpoints, and concrete data-collection guidance. The main weaknesses are incomplete disclosure of the bundle — three of five reference/script files are never linked, and the inline scoring rubric conflicts with the reference rubric's scale — plus minor verbosity from inlining content that also lives in reference files.
Suggestions
Link and reconcile the scoring systems: reference references/scoring-rubric.md from the Scoring Rubric section and align the inline 12-dimension 1–5 scale with the reference file's 1–10 weighted scale (or state explicitly which one governs).
Surface the two orphaned bundle files: mention scripts/competitive_matrix_builder.py (with its CLI invocation) in the workflow and references/competitive-analysis-frameworks.md in the Templates or analysis sections so they are discoverable.
Add a feedback loop to the validation checkpoints (e.g., "If a competitor has fewer than 20 reviews, substitute G2/Capterra reviews or note the gap in the evidence column") so data shortfalls have a defined recovery path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and skill-specific — a 12-dimension scoring table, an example completed scoring row, abbreviated templates, and a copy-paste App Store query — with deliberate summaries deferring full detail to references ("Full executable scripts for each source are in references/data-collection-guide.md. Summaries of what to capture are below"). It is not a 5 because the ~50-line inline Data Collection Guide section and the full inline 12-dimension rubric duplicate content that also lives in reference files, and could be trimmed further. | 4 / 5 |
Actionability | Mostly concrete and executable: a copy-paste iTunes Search API query with exact response fields ("Parse entry[].content.label for review text"), specific validation thresholds ("at least 3 sources per competitor", "at least 20 reviews"), and a worked example scoring row with real evidence. It falls short of 5 because the SEO and Social Media sections offer only capture-lists and defer all executable queries to the reference file, and the scripts/competitive_matrix_builder.py tool (which has a concrete CLI: "python competitive_matrix_builder.py competitors.json --format text") is never surfaced in the body. | 4 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced and includes explicit validation checkpoints on the two data-critical steps ("Validation checkpoint: Before proceeding, confirm you have pricing data, at least 20 reviews, and job posting counts for each competitor"; "Every dimension should have a score and at least one supporting evidence note"). It does not reach 5 because there are no feedback/error-recovery loops (e.g., what to do when a source yields fewer than 20 reviews) and steps 4–6 have no checkpoints. | 4 / 5 |
Progressive Disclosure | The two linked references (references/data-collection-guide.md and references/analysis-templates.md) exist, are one level deep, and are clearly signaled. However, scored against the actual bundle: references/scoring-rubric.md, references/competitive-analysis-frameworks.md, and scripts/competitive_matrix_builder.py are never referenced from SKILL.md, making 3 of 5 bundle files undiscoverable; worse, the inline 12-dimension 1–5 rubric conflicts with scoring-rubric.md's 1–10 weighted scale, creating two inconsistent scoring systems. This matches anchor 3 ("some structure but could be better organized") rather than anchor 4's "references mostly clear". | 3 / 5 |
Total | 15 / 20 Passed |