CtrlK
BlogDocsLog inGet started
Tessl Logo

agentic-workflows

Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.

56

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/agentic-workflows/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

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-designed router skill: the dispatcher instruction and task-to-file routing table are concrete and actionable, with one-level references to external prompt files. Its weaknesses are the ~48-line flat file list that pads the body while contradicting its own 'read only the files you need' instruction, plus path inconsistencies (`skills/` vs `.github/skills/`) and an unspecified mechanism for loading the external `github/gh-aw` files. Trimming the raw list and resolving the path ambiguity would make it fully executable.

Suggestions

Remove or drastically trim the flat 50-file list — the task-keyed routing table already names every file needed, and the raw list contradicts 'Read only the files you need' while doubling the skill's length.

Resolve the path inconsistency between `skills/agentic-workflow-designer/SKILL.md` in the routing table and `.github/skills/agentic-workflow-designer/SKILL.md` in the file list.

Specify concretely how to load files from `github/gh-aw` (e.g., the exact repo/path or fetch mechanism), since they are stated to be 'not available locally'.

DimensionReasoningScore

Conciseness

The routing table and dispatcher instructions are lean and assume Claude's competence (no concept explanations), but ~48 of ~75 lines are an exhaustive flat list of 50 file paths that largely duplicates the routing table — and it directly contradicts the instruction "Read only the files you need". This is noticeable padding that could be tightened, placing it between anchors 2 and 3, closer to mostly-efficient-with-some-unnecessary-content.

3 / 5

Actionability

The routing table gives concrete, executable task-to-file mappings with explicit paths, and the dispatcher instruction ("identify the task type, load the matching workflow prompt/skill file, and follow it directly") is specific. Minor gaps keep it below 5: the first routing entry says `skills/agentic-workflow-designer/SKILL.md` while the file list says `.github/skills/agentic-workflow-designer/SKILL.md` (inconsistent paths), and how to actually load files "from `github/gh-aw`" (a remote location, "not available locally") is never specified.

4 / 5

Workflow Clarity

The sequence is clear: identify task type → load the matching prompt/skill → follow it directly, with a built-in checkpoint ("ask a clarifying question if the correct prompt is unclear"). No destructive or batch operations, so heavy validation is not required. It falls short of anchor 5 due to unresolved ambiguity: the conflicting `skills/` vs `.github/skills/` paths and the unspecified mechanism for loading files from the external `github/gh-aw` location could stall execution.

4 / 5

Progressive Disclosure

The body acts as a proper overview that points to one-level-deep external prompt files, and the routing table is clear, well-signaled navigation (task → file). No local bundle files exist, so structure is judged on the body itself. The main gap is the flat, uncategorized 50-path dump, which is not organized or signaled as well as the task-keyed routing table — minor organization gaps match anchor 4 rather than the clean split of anchor 5.

4 / 5

Total

15

/

20

Passed

Description

58%Weight 40%Scale 1-5

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 concise and states a concrete, well-scoped capability (routing gh-aw workflow requests to the right prompts), with good third-person voice. Its main weaknesses are the absence of any explicit 'Use when...' trigger clause and reliance on the jargon abbreviation 'gh-aw' rather than natural user phrasing like 'GitHub Agentic Workflows'. Adding a trigger clause with natural synonyms would lift both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows (gh-aw) in this repository.'

Use the full natural term 'GitHub Agentic Workflows' alongside the 'gh-aw' abbreviation so users who say either phrase trigger the skill.

Include common user verbs currently missing from the description, such as 'update', 'edit', or 'fix', to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Route gh-aw workflow design/create/debug/upgrade requests to the right prompts" names the domain and four concrete action verbs (design, create, debug, upgrade) plus the routing behavior — several specific actions with minor gaps (e.g., 'update' and 'shared component' tasks covered only in the body). It falls short of the 5 anchor's comprehensive coverage and well above the 1-2 action coverage of anchor 3.

4 / 5

Completeness

The 'what' is clear (route requests to matching prompts for design/create/debug/upgrade), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the when is only weakly implied by the request-type list. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 3, and it does not fall to 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

Keywords present are 'gh-aw', 'workflow', 'design', 'create', 'debug', 'upgrade' — relevant but 'gh-aw' is technical jargon rather than the natural phrase a user would say ('GitHub Agentic Workflows'), and common variations like 'edit', 'fix', 'update', or 'build' are missing. Not as sparse as anchor 2's single generic term, but not the good coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — 'gh-aw workflow' routing is specific enough that unrelated skills would rarely trigger — but the term 'workflow' alone is broad and could overlap with general workflow/CI skills if a user doesn't say 'gh-aw'. Minor overlap risk matches anchor 4; not a clear-enough niche with distinct trigger phrases for a 5.

4 / 5

Total

14

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Z3Prover/z3
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.