This skill should be used when the user says "spark help", "arn spark help", "greenfield status", "greenfield help", "where am I in spark", "what's next for spark", "spark pipeline", "spark status", "arn-spark-help", "show spark pipeline", "what step am I on for spark", "spark workflow", "exploration status", "show exploration pipeline", "how does spark work", "explain spark pipeline", or wants to see their current position in the Arness Spark exploration pipeline and get guidance on the next step.
60
70%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-spark-help/SKILL.mdQuality
Discovery
62%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description excels at listing trigger phrases and is clearly distinctive to a specific domain (Arness Spark pipeline), but it severely lacks specificity about what the skill actually does. It reads more like a trigger-phrase catalog than a capability description, leaving Claude without a clear understanding of the skill's concrete actions and outputs.
Suggestions
Add concrete action descriptions before the trigger list, e.g., 'Displays the user's current stage in the Arness Spark exploration pipeline, shows completed and remaining steps, and provides actionable guidance for the next phase.'
Restructure to lead with capabilities using third-person voice (e.g., 'Shows pipeline progress, identifies current exploration stage, and recommends next actions'), then follow with a 'Use when...' clause consolidating the trigger phrases.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lists trigger phrases but never describes concrete actions the skill performs. It vaguely mentions 'see their current position' and 'get guidance on the next step' but doesn't specify what the skill actually does (e.g., display pipeline stages, provide step-by-step instructions, show progress metrics). | 1 / 3 |
Completeness | The 'when' is thoroughly covered with explicit trigger phrases, but the 'what' is extremely weak — it only vaguely says 'see their current position in the Arness Spark exploration pipeline and get guidance on the next step' without explaining what the skill concretely does or produces. | 2 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would say, covering many variations like 'spark help', 'spark status', 'what's next for spark', 'where am I in spark', 'spark pipeline', 'spark workflow', and 'exploration status'. These are realistic user utterances. | 3 / 3 |
Distinctiveness Conflict Risk | The skill targets a very specific named system ('Arness Spark exploration pipeline') with distinctive trigger terms like 'spark help', 'greenfield status', and 'arn spark help'. This is unlikely to conflict with other skills due to the unique domain terminology. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable read-only status detection skill with clear workflow sequencing and specific file-path-based detection rules. Its main weakness is verbosity — the inline FAQ, cross-plugin rendering examples, and some meta-commentary could be trimmed or moved to reference files. The tool constraints and error handling are clearly stated, making this a reliable skill despite being somewhat long.
Suggestions
Move the Step 4 FAQ answers into the referenced pipeline-map.md or a separate FAQ reference file to reduce the SKILL.md token footprint.
Trim the cross-plugin rendering examples in Step 3 to just the format pattern rather than showing multiple conditional variants inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some unnecessary verbosity. The FAQ section in Step 4 is extensive and could be offloaded to a reference file. The cross-plugin rendering examples in Step 3 add bulk. Some explanations (e.g., 'the user wants a quick status check, not a wall of text') are meta-commentary Claude doesn't need. | 2 / 3 |
Actionability | The skill provides highly specific, concrete detection rules with exact file paths to check, a clear priority ordering (most advanced to least), specific commands to suggest, and explicit rendering instructions. Every step has concrete criteria rather than vague guidance. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced across 5 steps (0-4) with explicit ordering logic ('first match wins'), clear conditional branching for different states, and well-defined error handling. Since this is a read-only detection skill, destructive operation validation is not applicable, and the workflow is thorough for its purpose. | 3 / 3 |
Progressive Disclosure | The skill references `pipeline-map.md` for detection rules, rendering templates, and next-step tables, which is good progressive disclosure. However, the FAQ section in Step 4 and the detailed cross-plugin rendering examples in Step 3 could be offloaded to reference files. The bundle has no files provided to verify the reference exists, but the path is clearly signaled. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
b9084b6
Table of Contents
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.