CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-concept-review

This skill should be used when the user says "concept review", "review concept", "update product concept", "synthesize stress tests", "stress test review", "apply stress test findings", "review stress test results", "concept update", "merge stress test recommendations", or wants to synthesize findings from completed stress tests into a reviewed and updated product concept document. Scans for stress test reports, consolidates recommendations, resolves conflicts using product pillars, presents the full changeset for user approval, and produces an updated product-concept.md alongside a concept-review-report.md.

74

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a well-structured, highly actionable multi-step orchestration skill with clear validation checkpoints and clean progressive disclosure. Its only weakness is conciseness: the Error Handling and Constraints sections duplicate guidance already present inline.

Suggestions

Remove the Error Handling entries that merely restate cases already handled inline (no reports found, file rename fails, user rejects all, write failures), or replace them with a one-line cross-reference; keep only the genuinely additional fallbacks.

Collapse the Constraints section to only the constraints not already enforced in the workflow body (e.g., report overwrites on re-run, ${CLAUDE_PLUGIN_ROOT}-only reference loading), trimming the restated ones to avoid duplication.

Trim repetition in the Step 5 approval branches (Accept all / Review by section / Review individually) by factoring the shared per-change Accept/Reject/Modify sub-pattern into a single referenced block.

DimensionReasoningScore

Conciseness

The body introduces no concept padding Claude already knows, but it is padded with redundancy: the Error Handling section re-covers cases already handled inline (no reports found, rename fails, reject all, write fails) and the Constraints section restates inline statements (only-skill-that-modifies, mandatory gate, preserve template, rename-preserves-original). That matches 'mostly efficient but could be tightened' rather than the lean score-3 anchor; it is not the verbose concept-explaining score-1 case.

2 / 3

Actionability

For an instruction-only orchestration skill the guidance is fully actionable: exact report filenames, exact extraction field lists (row number, section, current state, recommended change, type, rationale), exact AskUserQuestion prompts with option text, and exact Task-tool context templates with the model-parameter source. The scoring note explicitly exempts absence of code when guidance is this concrete.

3 / 3

Workflow Clarity

Steps 1-8 are clearly sequenced with explicit validation checkpoints -- a mandatory user approval gate before any write, conflict detection with pillar analysis, and a retry-then-escalate feedback loop for poor strategist consolidation -- matching the 'clear sequence with explicit validation steps and feedback loops' anchor.

3 / 3

Progressive Disclosure

The body is an overview that points to two real, one-level-deep bundle files (conflict-resolution-protocol.md and review-report-template.md), both clearly signaled and loaded in Step 1 via ${CLAUDE_PLUGIN_ROOT}; the conflict-resolution detail is split out rather than inlined, matching the 'clear overview with well-signaled one-level-deep references' anchor.

3 / 3

Total

11

/

12

Passed

Description

100%Weight 40%Scale 1-3

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 is strong across all dimensions: it states concrete actions, gives an explicit 'use when' trigger with many natural phrasings, and carves out a distinctive niche. It fully answers what the skill does and when to invoke it.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions -- 'Scans for stress test reports, consolidates recommendations, resolves conflicts using product pillars, presents the full changeset for user approval, and produces an updated product-concept.md alongside a concept-review-report.md' -- matching the score-3 anchor rather than the single-action score-2 example.

3 / 3

Completeness

Explicitly answers both 'what' (scan/consolidate/resolve/present/produce) and 'when' ('This skill should be used when the user says...'), satisfying the explicit-trigger requirement that would otherwise cap completeness at 2.

3 / 3

Trigger Term Quality

Provides ~9 natural phrases a user would actually say ('concept review', 'review concept', 'update product concept', 'synthesize stress tests', 'stress test review', 'apply stress test findings', 'review stress test results', 'concept update', 'merge stress test recommendations'), giving good coverage rather than the partial score-2 case.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche -- synthesizing completed stress-test findings into a reviewed product concept -- with distinct triggers, making it unlikely to fire for an unrelated skill; not the generic, overlapping score-2 case.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
AppsVortex/arness
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.