test-organization-helper
Test Organization Helper - Auto-activating skill for Test Automation. Triggers on: test organization helper, test organization helper Part of the Test Automation skill category.
32
0%
Does it follow best practices?
Impact
91%
1.01xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/09-test-automation/test-organization-helper/SKILL.mdQuality
Discovery
0%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is essentially a placeholder with no substantive content. It repeats the skill name as its only trigger term, provides zero concrete actions or capabilities, and lacks any 'Use when...' guidance. It would be indistinguishable from any other test-related skill in a multi-skill environment.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Reorganizes test files into logical directories, splits large test files by feature, groups related test cases, and generates test index files.'
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to organize tests, restructure test directories, group test cases, or clean up test file structure.'
Remove the redundant duplicate trigger term and replace with varied natural language terms users would actually say, such as 'organize tests', 'test structure', 'test file layout', 'sort test cases'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description provides no concrete actions whatsoever. 'Test Organization Helper' is a name, not a description of capabilities. There are no specific actions like 'reorganizes test files', 'groups tests by feature', or 'creates test directories'. | 1 / 3 |
Completeness | Neither 'what does this do' nor 'when should Claude use it' is meaningfully answered. The description only states the skill name, a redundant trigger, and a category label. There is no 'Use when...' clause or equivalent explicit trigger guidance. | 1 / 3 |
Trigger Term Quality | The only trigger terms listed are the skill name repeated twice ('test organization helper'). No natural user language is included—users would more likely say things like 'organize my tests', 'restructure test files', 'group test cases', or 'test folder structure'. | 1 / 3 |
Distinctiveness Conflict Risk | The description is extremely generic—'Test Automation' and 'test organization' could overlap with any number of testing-related skills. Without specific capabilities or file types, it would be nearly impossible to distinguish this from other test-related skills. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
0%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a placeholder with no substantive content. It contains no executable code, no concrete guidance on test organization, no workflows, and no references to supporting materials. Every section restates the skill name without providing any actionable information about how to actually organize tests.
Suggestions
Replace the generic 'Capabilities' section with concrete, executable examples of test organization patterns (e.g., directory structures, naming conventions, grouping strategies) for at least one framework like Jest or pytest.
Add a clear workflow with specific steps, such as: 1) Analyze existing test files, 2) Propose a directory structure, 3) Move/rename files, 4) Validate imports still resolve.
Include actual code snippets showing test organization patterns (e.g., pytest conftest.py setup, Jest describe/it nesting, test file naming conventions) rather than describing capabilities abstractly.
Remove all filler text like 'Provides step-by-step guidance' and 'Follows industry best practices'—these waste tokens and tell Claude nothing it doesn't already know.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic filler that tells Claude nothing useful. Phrases like 'Provides step-by-step guidance' and 'Follows industry best practices' are vacuous. It explains what triggers are and restates the skill name repeatedly without adding any actionable information. | 1 / 3 |
Actionability | There is zero concrete guidance—no code, no commands, no specific patterns, no examples of test organization. The entire skill describes what it could do rather than instructing Claude how to do anything. | 1 / 3 |
Workflow Clarity | No workflow, steps, or process is defined. The skill claims to provide 'step-by-step guidance' but contains none. There are no validation checkpoints or sequenced instructions. | 1 / 3 |
Progressive Disclosure | The content is a monolithic block of generic marketing-style text with no references to supporting files, no structured sections with real content, and no navigation to deeper material. There are no bundle files to support it either. | 1 / 3 |
Total | 4 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
13d35b8
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.