Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable overview of testing conventions with some concrete elements (bash commands, directory structure), but leans heavily on general testing best practices that Claude already knows. It would benefit from project-specific examples, concrete test code patterns, and less restating of universal testing wisdom.
Suggestions
Replace generic advice (e.g., 'test one thing per test', 'Arrange-Act-Assert') with project-specific test examples showing the actual testing framework, assertion style, and patterns used in this codebase.
Add a concrete, executable example of a unit test and an integration test using the project's actual test framework and conventions.
Include a brief workflow for writing a new test: create file in correct directory → follow naming convention → run tests → check coverage threshold.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably concise but includes some guidance that Claude already knows well (e.g., 'Test one thing per test', 'Mock external dependencies', Arrange-Act-Assert pattern). Several bullet points state general testing wisdom rather than project-specific conventions. | 2 / 3 |
Actionability | The bash commands for running tests are concrete and executable, and the directory structure is specific. However, the bulk of the content is general advice ('use descriptive test names', 'keep tests fast') rather than concrete, project-specific examples of test code or patterns to follow. | 2 / 3 |
Workflow Clarity | The test running commands are clearly listed, and the directory structure provides orientation. However, there's no workflow for writing a new test (e.g., create file → write test → run → verify coverage), and no validation checkpoints or feedback loops for ensuring test quality. | 2 / 3 |
Progressive Disclosure | For a simple skill under 50 lines with no need for external references, the content is well-organized into clear sections (Unit Tests, Integration Tests, Running Tests, Test Structure, Best Practices, Coverage Goals) that are easy to scan and navigate. | 3 / 3 |
Total | 9 / 12 Passed |