CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

resolution-advisor

Provide Red Hat documentation-backed resolution recommendations for classified job errors. Use when: - After failure analysis and host fact inspection: "How do I fix this?" - "What does Red Hat recommend for this error?" - "What's the fix for privilege escalation timeout?" - "Is this a known AAP issue?" NOT for: analyzing events (use job-failure-analyzer first) or checking host facts (use host-fact-inspector first).

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./rh-automation/skills/resolution-advisor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured, highly actionable advisory skill with a clear gated workflow, a concrete mapping table, and a complete output template plus worked example. Its weaknesses are duplicated prerequisite/dependency boilerplate that could be tightened, and progressive disclosure that breaks in practice because the required job-troubleshooting.md reference is a dead pointer stub and governance-readiness.md is referenced without any navigable path.

Suggestions

Consolidate the 'Required MCP Servers: None required' statement — currently repeated across the Prerequisites and Dependencies sections (three separate 'None' bullets) — into a single line.

Make references/aap/job-troubleshooting.md contain the actual failure-pattern content (or a resolvable link to the owning skill's copy); as shipped it is a 67-byte pointer whose target does not exist in the bundle, so the required Step 1 read yields nothing.

When citing governance-readiness.md domains in Step 3 and Step 4, link the file path the same way error-classification.md and job-troubleshooting.md are linked, so the domain references are navigable.

DimensionReasoningScore

Conciseness

The body is mostly efficient (a mapping table, an output template, a worked example), but it carries clear slack: "Required MCP Servers: None required" is stated in the Prerequisites section and then repeated verbatim in Dependencies as two more "None" bullets, and emphatic filler like "**CRITICAL**: Document consultation MUST happen BEFORE providing recommendations" restates the numbered ordering. This matches the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is fully executable for an advisory skill: exact files to read by path, a 10-row classification-to-resolution-owner-to-doc mapping table, a complete copy-paste output template, and a worked example advisory for a package-not-found error. It matches the 5 anchor (specific examples cover the common cases); a 4 would leave gaps in the template or example.

5 / 5

Workflow Clarity

The four steps are clearly sequenced (consult docs first, map resolution path, generate advisory, suggest governance improvements) with a hard gate that documents be consulted before recommending and a verification step required in every advisory. It falls short of 5 because there is no feedback loop or fallback for unresolvable inputs — e.g., what to do when the classification doesn't match any row of the table or the cited reference is unavailable.

4 / 5

Progressive Disclosure

References are clearly signaled and one level deep, and error-classification.md is substantive, but scoring against the actual bundle reveals real navigation failures: references/aap/job-troubleshooting.md — a REQUIRED Step 1 read — is a 67-byte pointer file whose target (../../../job-failure-analyzer/...) does not exist in the bundle, so following the link yields no content; governance-readiness.md domains (Domains 2–6) are invoked repeatedly but never linked or given a path; and the inline 10-row resolution table duplicates the "resolution path mapping" already promised by error-classification.md. This fits the 3 anchor (some structure, could be better organized) better than 4, where reference resolution would be sound with only minor gaps.

3 / 5

Total

15

/

20

Passed

Description

82%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 strong description with explicit what/when/what-not structure, quoted natural trigger phrases, and explicit disambiguation from sibling skills. Its only notable gap is that the capability statement is a single bundled action rather than several specific listed actions.

DimensionReasoningScore

Specificity

"Provide Red Hat documentation-backed resolution recommendations for classified job errors" names the domain (AAP job errors) and one concrete action (documentation-backed resolution recommendations), but does not enumerate the constituent actions (mapping classifications to resolution paths, generating advisories, suggesting governance improvements). It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than 4, which requires several specific listed actions.

3 / 5

Completeness

It explicitly answers what ("Provide Red Hat documentation-backed resolution recommendations for classified job errors") and when (a "Use when" list with concrete trigger phrases), plus a "NOT for" exclusion clause. This matches the 5 anchor: both what and when clearly and explicitly stated with concrete trigger phrases; a 4 would require a weaker or less explicit 'when'.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted directly: "How do I fix this?", "What does Red Hat recommend for this error?", "What's the fix for privilege escalation timeout?", "Is this a known AAP issue?" — good keyword coverage (fix, error, known issue, AAP). It falls short of 5 because common synonyms and product-name variants (troubleshoot, resolve, Ansible Automation Platform, playbook failure) are absent.

4 / 5

Distinctiveness Conflict Risk

"NOT for: analyzing events (use job-failure-analyzer first) or checking host facts (use host-fact-inspector first)" explicitly disambiguates against the sibling skills most likely to collide, and the niche (resolution recommendations downstream of classification) is distinct. Minimal conflict risk; matches the clear-niche 5 anchor.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 3 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

RHEcosystemAppEng/agentic-plugins

Path

rh-automation/skills/resolution-advisor/SKILL.md

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.