CtrlK
BlogDocsLog inGet started
Tessl Logo

agentic-workflows

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

61

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

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

The canonical home for this skill is agentic-workflows in github/gh-aw

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A well-designed router skill: lean prose, fully executable file-based routing, and a clear dispatch sequence with a clarifying-question fallback and overlay precedence rules. Its main weakness is token efficiency — the bulk raw file listing substantially duplicates the curated routing table, and an undifferentiated index blurs otherwise excellent navigation.

Suggestions

Collapse the 75-file raw listing into a compact note (e.g. 'the full upstream file list is in github/gh-aw/.github/aw/') and keep only the curated routing table, saving ~70 lines of tokens.

Annotate the remaining listed files with a short purpose tag each (or group them by topic) so the index is navigable rather than an undifferentiated path dump.

State upfront that the routing table is the primary navigation and the file list is a completeness fallback, so Claude knows which to consult first.

DimensionReasoningScore

Conciseness

The prose is lean with zero concept over-explanation, but the 75-line raw file listing (lines 18-92) largely duplicates the curated routing table at the end — most listed files are never referenced by any routing rule. Mostly efficient, but it could be tightened by listing only the files not covered in the routing table, which matches anchor 3 rather than the 'minor trims' of anchor 4.

3 / 5

Actionability

Fully executable guidance: exact file paths per task type ('Design workflows from scratch via interview: .github/aw/designer.md'), a copy-paste-ready overlay load ('load it with @.github/aw/instructions.md'), and an explicit conditional extension for OTEL ('skills/otel-queries/SKILL.md'). Every instruction is a concrete, directly performable action with specific examples covering the common cases.

5 / 5

Workflow Clarity

The dispatcher sequence is fully specified: identify the task type, load the matching prompt/skill, optionally apply the repository overlay with an explicit precedence rule, then follow the loaded prompt. There is an explicit error-recovery fallback ('ask a clarifying question if the correct prompt is unclear'), and as a simple non-destructive router there is nothing to validate. It is not score 4 because no checkpoint or step is missing or implicit.

5 / 5

Progressive Disclosure

Scored against the actual bundle: no local bundle files exist, and the body's references are all well-signaled, one-level-deep pointers into the external 'github/gh-aw' tree, with a routing table that makes navigation easy. The minor gap is the undifferentiated 75-file index dumped before the routing table — files are enumerated without any indication of what each is for — which keeps it below anchor 5's 'easy navigation' standard.

4 / 5

Total

17

/

20

Passed

Description

61%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.

A concise, distinct one-line description with a clear single capability (routing), but it omits any explicit 'Use when' trigger guidance and leans on product jargon ('gh-aw') without spelling out the full domain name. It reads more like a router stub than a complete trigger description.

Suggestions

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

Spell out 'GitHub Agentic Workflows' at least once so users who say the full product name (not just 'gh-aw') naturally match the description.

Include a few more natural trigger synonyms users would say, such as 'agents', 'triggers', 'MCP wrappers', or 'shared workflow components', to broaden coverage beyond design/create/debug/upgrade.

DimensionReasoningScore

Specificity

The description names the domain ('gh-aw workflow') and one concrete action ('Route ... requests to the right prompts'), but design/create/debug/upgrade are the request types rather than additional capabilities, so coverage is not comprehensive. It is a step above anchor 2 (which would only name the domain with a generic action) but lacks the several specific actions needed for 4.

3 / 5

Completeness

The 'what' is clear (route requests to the right prompts) but there is no 'Use when...' clause or equivalent; the 'when' is only weakly implied by the enumerated request types. Per the judging guidelines a missing explicit trigger clause caps completeness at 3, and it is not score 2 because the 'what' is concrete and the 'when' is implied.

3 / 5

Trigger Term Quality

Good natural keywords users would say: 'workflow', 'design', 'create', 'debug', 'upgrade'. 'gh-aw' is product jargon and the full name 'GitHub Agentic Workflows' plus synonyms like 'agents', 'triggers', or 'MCP' are missing, keeping it short of comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'gh-aw workflow' pins a distinct niche with minimal conflict risk, but the generic verbs 'design', 'create', 'debug', and 'upgrade' combined with 'workflow' could overlap with CI/GitHub Actions or general workflow skills. Mostly distinct with minor overlap risk — anchor 5 would require trigger phrases that unambiguously isolate this skill.

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
Azure/azure-sdk-for-net
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.