CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

work-end-day

End-of-day — draft and post daily comments for tracked tickets missing a comment

Quality

76%

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 ./.agents/skills/work-end-day/SKILL.md
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 exemplary operational runbook: every step is executable with exact commands and templates, validation and approval checkpoints guard the batch posting and state-change operations, and failure modes are handled explicitly down to note-field consistency. Its only weaknesses are mild verbosity in the worked example and no use of external reference files despite the length.

DimensionReasoningScore

Conciseness

The body is dominated by lean, purposeful content — exact bash commands, comment templates, and an edge-case table — with almost no explanation of concepts Claude already knows. It falls short of anchor 5 because the full two-ticket worked example in Step 4 and the repeated return-to-Todo post block in Step 5 could be tightened.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: exact date/note-path bash, `linear issue view <TICKET-ID> -j --no-comments --no-pager`, `--body-file` posting with heredocs, `--state unstarted` with a note on name-vs-type, exact note-edit strings, and concrete credential/sandbox retry handling. Specific examples cover the common cases including empty logs and failure paths.

5 / 5

Workflow Clarity

Steps 1–6 are clearly sequenced with explicit validation checkpoints for a batch operation: Linear state verification before any revert, an AskUserQuestion approval gate before posting, per-item error recovery (comment posts but state change fails → keep `status::` matching reality), and a keyring-error retry loop. This matches the anchor with feedback loops and error-recovery checklists; the batch-operation cap does not apply since validation is thorough.

5 / 5

Progressive Disclosure

The single file is well-organized into sequenced step sections plus an Edge Cases table with no nested or buried references, and no bundle files exist to misroute. It falls short of anchor 5 because at ~235 lines everything is inline — the long worked example in Step 4 and the edge-case table are candidates for a separate reference file — and it does not meet the under-50-line simple-skill exception.

4 / 5

Total

18

/

20

Passed

Description

53%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 states a clear, specific core function in third person with natural trigger phrasing around "end-of-day" and "daily comments", but it lacks an explicit "when to use" clause and never mentions Linear, the system it operates on. It also undersells the skill by omitting the revert-to-Todo behavior, making coverage incomplete for a reader deciding whether to invoke it.

Suggestions

Add an explicit trigger clause, e.g. "Use at the end of the workday to post end-of-day Linear comments for tracked tickets that haven't been commented on today."

Name the target system (Linear) and mention the secondary capability, e.g. "...and returns idle in-progress tickets to Todo with a note."

Include a natural synonym or two users might say (e.g. "end of day", "wrap-up") to broaden trigger term coverage.

DimensionReasoningScore

Specificity

"draft and post daily comments for tracked tickets missing a comment" names two concrete actions with a precise target, but omits a major documented capability (returning idle in-progress tickets to Todo), so coverage is not comprehensive. It is above anchor 2 because the actions are specific rather than generic, but below anchor 4 because the gap is significant rather than minor.

3 / 5

Completeness

The "what" is clear (draft and post daily comments for tickets missing one), but there is no "Use when..." clause or equivalent explicit trigger guidance — "End-of-day" only weakly implies timing. Per the judging guideline, a missing explicit trigger clause caps completeness at 3 even with a clear what.

3 / 5

Trigger Term Quality

"End-of-day", "daily comments", and "tracked tickets" are natural phrases, but "Linear" — the actual system being commented on — never appears, and common synonyms (wrap-up, standup) are missing. This matches anchor 3 (some relevant keywords, missing common variations), falling short of anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The end-of-day daily-comment niche for tracked tickets is fairly distinct and unlikely to trigger the wrong skill. It falls short of anchor 5 because "Linear" is not named, leaving minor overlap risk with other ticketing or commenting skills.

4 / 5

Total

13

/

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

phatblat/dotfiles

Path

.agents/skills/work-end-day/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.