CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drivers-ticket-assistant

Help the user understand and complete their assigned DOCSP tickets for drivers. Provides a prioritized overview of all assigned tickets and suggests next steps. Use only when the user explicitly uses the slash command.

60

Quality

75%

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 ./.claude/skills/drivers-ticket-assistant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

An impressively actionable, well-structured workflow skill: concrete gh/Jira commands with placeholders, explicit numeric thresholds, per-status decision trees, and graceful degradation when each prerequisite is missing. Its weaknesses are minor — one ambiguous band in the reviewer-classification heuristic, a thrice-repeated wiki URL, and no validation checkpoint that a located PR matches the ticket.

Suggestions

Close the 10-19 commit gap in the reviewer classification heuristic (e.g. '10-19 commits: treat as internal only if the author appears in docs team PR review requests, otherwise ask the user').

Define the Confluence wiki URL once (e.g. in a Prerequisites note) and reference it by name elsewhere to trim repeated tokens.

Add a quick verification step after the PR search (e.g. confirm the PR body or branch references the ticket key before classifying reviewers).

DimensionReasoningScore

Conciseness

The body is dense and directive with no concept-explanation padding — no what-Jira-is or how-GitHub-works text — and every section carries instructions. Minor waste keeps it at anchor 4 rather than 5: the full Confluence wiki URL is repeated verbatim three times (Prerequisites, Internal Review, External Review) and could be defined once, and the prerequisites prose could be slightly tightened.

4 / 5

Actionability

Highly executable throughout: copy-paste-ready commands ('gh search prs "<ticket key>"', 'gh pr view <number> --json reviewRequests,reviews', 'gh api "repos/10gen/docs-mongodb-internal/commits?author=<login>&per_page=20"', '?expand=changelog'), explicit thresholds (2+ days, 3+ days, P1-P5, 2+ years), and drafted Slack message templates. Anchor 4 rather than 5 because the internal/external reviewer heuristic only defines >=20 commits and <10 commits, leaving the 10-19 range undefined.

4 / 5

Workflow Clarity

Clear two-step sequence with argument routing (no argument / ticket key / category), per-status decision trees, a prerequisite-degradation path for each dependency (jira missing -> stop; gh missing -> skip PR lookups; MCP missing -> link the wiki), and suggested ticket closures routed through user confirmation. Anchor 4 rather than 5 because there are no explicit validation checkpoints on fetched data (e.g. verifying a found PR actually corresponds to the ticket); the read-mostly, suggest-only nature of the skill means the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

A single-file skill with no bundle (no references/, scripts/, or assets/ directories) and clean, well-signaled section structure (Arguments, Prerequisites, Priority Order, Step 1, Step 2 with per-status branches) — nothing is nested or buried. Anchor 4 rather than 5: the content is well organized and appropriately sized at ~105 lines, but detail such as the reviewer-classification heuristic and follow-up message templates is a candidate for a one-level-deep reference file if the skill grows.

4 / 5

Total

16

/

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.

A solid, appropriately scoped description for an internal slash-command skill: it answers both what it does and when to use it, and its DOCSP/drivers niche makes conflicts unlikely. Its main weakness is trigger-term coverage — the word 'Jira' and other natural phrasings users would say are absent, and the action list stops at overview + next steps.

Suggestions

Add natural trigger keywords to the description, e.g. mention 'Jira' explicitly ('...their assigned Jira DOCSP tickets...') so users saying 'Jira' or 'my tickets' surface the skill.

Enumerate one or two more concrete actions (e.g. 'classify PR reviewers, find blocked tickets, and draft reviewer follow-up messages') to raise specificity beyond overview + next steps.

DimensionReasoningScore

Specificity

Names the domain ('their assigned DOCSP tickets for drivers') with two concrete actions ('Provides a prioritized overview of assigned tickets and suggests next steps'), but 'understand and complete' is generic and no broader action list is given. Fits anchor 3 (domain plus 1-2 concrete actions, not comprehensive); not 4 because it does not list several specific actions.

3 / 5

Completeness

Both parts are explicit: the 'what' ('understand and complete their assigned DOCSP tickets... prioritized overview... suggests next steps') and the 'when' ('Use only when the user explicitly uses the slash command'). Anchor 4 fits — both present but the 'when' is a narrow invocation gate rather than the concrete task-domain trigger phrases that would earn a 5; not 3 because the 'when' clause is fully explicit.

4 / 5

Trigger Term Quality

Relevant keywords exist ('DOCSP tickets', 'drivers', 'assigned tickets', 'next steps', 'slash command'), but common natural variations are missing — most notably 'Jira', along with terms like 'backlog' or 'what to work on'. Fits anchor 3 (some relevant keywords, missing common variations); not 4 because 'Jira' is the term users would most naturally use for this skill.

3 / 5

Distinctiveness Conflict Risk

'DOCSP tickets for drivers' plus 'explicitly uses the slash command' carves out a clear niche with minimal conflict risk, distinguishable even from a generic Jira/ticket skill. Clearly matches anchor 5; anchor 4's 'minor overlap risk with closely related skills' is too weak given the project/team qualifiers.

5 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

mongodb/docs

Path

.claude/skills/drivers-ticket-assistant/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.