CtrlK
BlogDocsLog inGet started
Tessl Logo

create-workflow

Conversational guide for creating valid YAML workflow definitions. Use when asked to "create a workflow", "new workflow definition", "build a workflow", "workflow YAML", "define workflow steps", or "workflow from template".

69

Quality

83%

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

77%

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

A well-organized, actionable authoring guide with a solid validation feedback loop. Its weaknesses are redundant restatements of the path-traversal and output-location rules, and several routing/template references that point to files absent from the bundle.

Suggestions

Remove the dedicated <Path Traversal Guard> section and the duplicate Output Location block under essential_principles; these rules already appear in Validation Rules and Parameter Substitution, and output conventions are restated in <output_conventions>.

The routing section references workflows/create-from-scratch.md and workflows/create-from-template.md, and <templates_index> lists four templates/*.yaml files, but none of these exist in the bundle — either add the missing files or correct the references.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no basic-concept padding), but the path-traversal rule is restated three times (Validation Rules, Parameter Substitution, and a dedicated Path Traversal Guard section) and output locations are repeated in both essential_principles and output_conventions, so it could be tightened.

2 / 3

Actionability

It gives concrete, specific guidance: exact field names and ordering, exact CLI commands ("/gsd workflow validate <name>"), exact output paths, and indentation rules — fully actionable for an instruction-only skill.

3 / 3

Workflow Clarity

The routing section sequences intent to action and the output_conventions checklist ends with an explicit validation checkpoint ("Run /gsd workflow validate <name>... then /gsd workflow <name>"), giving a clear validate-then-run feedback loop.

3 / 3

Progressive Disclosure

The overview is well-structured with clearly signaled one-level-deep references to the three real references/*.md files, but routing points to workflows/create-from-scratch.md and create-from-template.md and templates_index lists four templates/*.yaml files — none of which exist in the bundle.

2 / 3

Total

10

/

12

Passed

Description

90%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that concisely states its purpose and provides explicit, natural trigger phrases. Its only weakness is naming a single action rather than enumerating multiple concrete capabilities.

DimensionReasoningScore

Specificity

It names the domain and a concrete action ("creating valid YAML workflow definitions") but lists only a single action rather than multiple distinct ones, so it stops short of the comprehensive 3-anchor.

2 / 3

Completeness

It states what the skill does ("Conversational guide for creating valid YAML workflow definitions") and gives an explicit "Use when asked to..." trigger clause, answering both what and when.

3 / 3

Trigger Term Quality

The "Use when asked to..." clause enumerates natural phrases users would actually say ("create a workflow", "build a workflow", "workflow YAML", "workflow from template") with good coverage of variations.

3 / 3

Distinctiveness Conflict Risk

It targets a clear niche (GSD V1 YAML workflow definitions) with workflow-specific triggers, making it unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
gsd-build/gsd-2
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.