CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-triage

Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is an exceptionally actionable, well-sequenced operational playbook: exact commands, tools, templates, and error-recovery loops cover every phase and every issue source. The only tightening opportunities are minor wording redundancy and potentially moving the domain-label table and rating guides into a reference file.

DimensionReasoningScore

Conciseness

The body is dense and imperative — every section instructs rather than explains, with no padding about concepts Claude already knows. It is a 4 rather than 5 due to minor redundancy, e.g. the non-GitHub skip rule is stated per-source in Phase 1 ("skip GitHub-only author-history commands below") and then restated as "Jira, incident.io, and GitLab issues, like Linear, skip the GitHub-only author-history commands below", plus filler like "Always be critical of your findings!"

4 / 5

Actionability

Guidance is fully executable: exact commands ("gh issue view <number> --json title,body,labels,comments,assignees,state,author"), exact tool calls ("github_upsert_factory_triage_comment"), a copy-paste bash loop for domain labels, the literal marker string, and a complete fill-in handoff template with placeholder rules. It is not a 4 because commands are copy-paste ready and the common cases (GitHub, Linear, Jira, incident.io, GitLab) are each covered specifically.

5 / 5

Workflow Clarity

Five clearly sequenced phases with explicit validation checkpoints and error-recovery feedback loops: publication is confirmed via "Use its returned canonical comment identity to confirm publication", label state is reconciled ("keep exactly the selected effort label, exactly the selected impact label"), and transition rejections have explicit handling ("approval_required" is never retried; other rejections are corrected and retried once). This matches the top anchor's sequence + validation + feedback-loop pattern; the adjacent 4 anchor would require missing checkpoints, which are present.

5 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-sectioned (Phase 1-5, Output contract, Behavior Rules) with everything needed at runtime inline, which is appropriate for an operational skill where the commands, template, and rating guides are needed every run. It is a 4 rather than 5 because a 17-row domain-label table and three rating guides are inlined where a references/ file could hold them, and the ~230-line body is at the upper bound of what one file should carry; it is above 3 because structure and navigation are clear and no content is misplaced or buried.

4 / 5

Total

18

/

20

Passed

Description

66%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 action-oriented, naming four concrete steps in a distinctive Factory-specific niche. Its main weakness is the missing 'when to use' clause, which caps completeness and weakens trigger guidance for users deciding whether to invoke it.

Suggestions

Append an explicit trigger clause, e.g. "Use when a Factory work item references a GitHub, GitLab, Linear, Jira, or incident.io issue that needs triage and stage advancement."

Mention the supported issue sources (GitHub, GitLab, Linear, Jira, incident.io) to improve both trigger-term coverage and capability specificity.

Include the key deliverable in the 'what' — posting a structured triage handoff (verdict, severity, root cause) — so the skill's output contract is visible from the description.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "trace history, understand architecture, diagnose root cause, then advance the stage" — anchored in a named domain ("a Factory work item's issue"). It stays at 4 rather than 5 because coverage has gaps (no mention of supported sources like GitHub/Linear/Jira, or the handoff/labeling output), and above 3 because it lists several specific actions rather than just 1-2.

4 / 5

Completeness

The 'what' is clear (trace history, understand architecture, diagnose root cause, advance the stage), but there is no "Use when..." clause or equivalent explicit trigger guidance — matching the anchor "Has a clear 'what' but 'when' is missing or only weakly implied" and capping completeness at 3 per the judging guidelines. It is not a 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

It contains natural domain keywords a user would say — "Triage", "issue", "diagnose root cause" — giving good keyword coverage. It falls short of 5 because common variations and synonyms ("investigate", "debug", "bug report", "diagnosis") are missing, and "Factory work item" leans toward platform jargon over natural phrasing.

4 / 5

Distinctiveness Conflict Risk

"Factory work item's issue" and "advance the stage" pin the skill to a clear Factory-platform niche, making it mostly distinct. It is not 5 because generic trigger phrases like "diagnose root cause" create minor overlap risk with general debugging/triage skills; not 3 because the Factory framing goes well beyond 'somewhat specific'.

4 / 5

Total

15

/

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

mastra-ai/mastra

Path

mastracode/factory/factory-skills/factory-triage/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.