CtrlK
BlogDocsLog inGet started
Tessl Logo

document-in-case

Add a comment to a case to document findings, actions, or recommendations. Use to maintain audit trail during investigations. Requires CASE_ID and comment text.

69

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/document-in-case/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid, focused description for a narrow-scope skill. It clearly communicates what the skill does and when to use it, with required parameters specified. The main weakness is that trigger term coverage could be broader to capture natural language variations users might employ when wanting to add notes or comments to cases.

Suggestions

Add natural language variations users might say, such as 'add note', 'annotate', 'log activity', 'case notes', or 'document progress' to improve trigger term coverage.

Consider expanding the capability description slightly to mention related actions if applicable, such as viewing existing comments or updating comments, to better differentiate from other case management skills.

DimensionReasoningScore

Specificity

The description names a specific action ('Add a comment to a case') and mentions the domain (investigations, audit trail), but it only describes a single action rather than listing multiple concrete capabilities. It does mention required parameters (CASE_ID and comment text), which adds some specificity.

2 / 3

Completeness

Clearly answers both 'what' (add a comment to a case to document findings, actions, or recommendations) and 'when' ('Use to maintain audit trail during investigations'). It also specifies required inputs (CASE_ID and comment text), providing explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes some relevant keywords like 'comment', 'case', 'audit trail', 'investigations', 'findings', 'actions', 'recommendations'. However, it misses natural variations users might say such as 'add note', 'annotate case', 'case notes', 'log activity', or 'document progress'.

2 / 3

Distinctiveness Conflict Risk

The description is quite specific to case management commenting with clear triggers (CASE_ID, comment, case, audit trail, investigations). It is unlikely to conflict with other skills due to its narrow, well-defined scope.

3 / 3

Total

10

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill covers a straightforward single-API-call task but is padded with inline comment templates that would be better referenced externally. The core workflow is clear but the verification step is vague, and the API call is pseudocode rather than executable. The templates add value but hurt conciseness and progressive disclosure.

Suggestions

Make Step 2 concrete: show how to check the API response (e.g., check return value, status code, or specific field) rather than just saying 'check the API response'.

Move comment templates to a separate TEMPLATES.md file and link to it from the main skill, keeping the core skill lean.

Make the API call in Step 1 more executable—clarify the exact function signature and expected parameter types rather than using pseudocode-style comments.

DimensionReasoningScore

Conciseness

Mostly efficient but the comment templates section adds bulk that could be in a separate file. The core skill is a single API call, so the templates inflate the content relative to the actual instruction.

2 / 3

Actionability

The API call is shown but as pseudocode rather than fully executable code. The verify step is vague ('Check the API response') with no concrete code for how to verify success.

2 / 3

Workflow Clarity

Steps are listed but Step 2 ('Check the API response to confirm') lacks any concrete validation logic or error handling. For an operation that modifies case data, a more explicit verification step would be expected.

2 / 3

Progressive Disclosure

The comment templates are useful but lengthy and would be better placed in a separate reference file. The skill inlines all templates rather than linking to them, making the main file heavier than necessary.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
dandye/ai-runbooks
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.