CtrlK
BlogDocsLog inGet started
Tessl Logo

detail-bugs

Interact with Detail bugs for a repository via the CLI — list and filter bugs, inspect reports, close as resolved or dismissed, and reopen previously closed bugs.

85

3.33x
Quality

77%

Does it follow best practices?

Impact

100%

3.33x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/detail-bugs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 does well at listing specific concrete actions and identifying a clear niche (Detail bugs via CLI). However, it lacks an explicit 'Use when...' clause which limits its completeness score, and could benefit from additional natural trigger terms that users might use when requesting this functionality.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user asks about Detail bugs, wants to review bug reports, or needs to manage bug status via the CLI.'

Include additional natural trigger terms like 'bug tracker', 'issues', 'bug reports', or 'detail CLI' to improve keyword coverage.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: list and filter bugs, inspect reports, close as resolved or dismissed, and reopen previously closed bugs. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers 'what does this do' with specific actions, but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the description of capabilities.

2 / 3

Trigger Term Quality

Includes relevant terms like 'bugs', 'CLI', 'close', 'reopen', 'filter', but 'Detail' is a specific product name that users may or may not use naturally. Missing common variations like 'bug tracker', 'issues', or 'defects'.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Detail bugs' as a specific product/tool combined with 'CLI' creates a clear niche. This is unlikely to conflict with generic bug tracking or issue management skills.

3 / 3

Total

10

/

12

Passed

Implementation

87%

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-crafted reference skill that efficiently documents the Detail CLI bugs interface. It excels at conciseness and actionability, providing exact flag syntax, valid values, and defaults without unnecessary explanation. The main weakness is the lack of explicit workflow guidance for common multi-step operations like triaging a bug (list → show → close), though for a primarily reference-oriented skill this is a minor gap.

Suggestions

Consider adding a brief 'Common workflows' section showing a typical sequence like: list pending bugs → inspect a specific bug → close it, to improve workflow clarity for multi-step operations.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It doesn't explain what bugs are or how CLIs work. Every section delivers only the flags, options, and behaviors Claude needs. The brief prerequisites and repo inference sections are justified as they contain non-obvious setup and behavioral details.

3 / 3

Actionability

Every subcommand includes concrete flags with exact syntax, valid values, and defaults. The install command is copy-paste ready, flag combinations are shown with examples (e.g., `--status resolved,dismissed`), and behavioral notes like interactive TTY prompting vs explicit flags are specified.

3 / 3

Workflow Clarity

The skill clearly documents individual commands but doesn't provide an explicit workflow sequence for common multi-step scenarios (e.g., list → show → close). The authentication error recovery is mentioned but is more of a fallback note than a structured feedback loop. For a reference-style skill this is adequate but not exemplary.

2 / 3

Progressive Disclosure

For a skill with no bundle files and a focused scope (four subcommands), the content is well-organized with clear section headers per subcommand. The content is appropriately sized for a single file and doesn't need external references. Navigation is straightforward.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
usedetail/cli
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.