CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

log-work

Log the work segment that you did after the last work log until now in a log file at WORKLOG/YYYYMMDD.md where YYYYMMDD is based on today's date. The intent of this worklog is not to be exhaustive and super detailed. It is meant more as a very concise description plus, importantly, REFERENCES to more detailed documents such as code files or markdown documents, etc. This allows humans as well as AI agents to only refer to these additional documents if they want details. This is the progressive disclosure principle.

Quality

77%

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 ./plugins/workflow/skills/log-work/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 body is a lean, well-organized instruction for a single benign task: an explicit create-or-append sequence, a concrete section-header example, and a judgment-scoped content checklist. Its only weaknesses are small executable gaps — how to obtain the session_id and whether/how to create the WORKLOG directory — which hold actionability and workflow clarity just short of full marks.

Suggestions

State where to find the session_id (or mark it optional/conditional) so that checklist item is executable without external knowledge.

Extend step 1 to create the WORKLOG/ directory if it doesn't exist, since file creation fails in a missing parent directory.

Specify the timestamp source for the HH:MM header (e.g., current local time) to remove the last execution ambiguity.

DimensionReasoningScore

Conciseness

The ~25-line body is pure instruction with zero concept explanation: three numbered steps ("create the file WORKLOG/YYYYMMDD.md if it doesn't already exist", "append a new TOP-LEVEL markdown section"), one concrete example ("# 13:45 Added feature xyz"), and a scoped checklist ("a CONCISE set of items such as the following (Not all may apply to all situations, use your judgement)"). This matches anchor 5 ("lean and efficient; assumes Claude's competence; every token earns its place") — there is no over-explanation to trim, so it is not anchor 4.

5 / 5

Actionability

The guidance is mostly executable: an exact file path, an explicit create-vs-append rule, a copy-ready section-header example, and a specific itemized checklist ("the session_id of the current session", "any text/md file(s) you CREATED and their purpose", "which code files were created/changed"). It falls short of anchor 5 because one checklist item — "the session_id of the current session" — gives no indication of how to obtain it, a minor gap characteristic of anchor 4 ("mostly executable guidance... minor gaps"). It is well above anchor 3 since there is no pseudocode and no missing key details about the core action.

4 / 5

Workflow Clarity

The create-or-append sequence is numbered and unambiguous, with a concrete header format ("HH:MM timestamp followed by suitable concise topic") demonstrated by example. Two small gaps keep it at anchor 4 rather than 5 under the simple-skill exception: creating the WORKLOG/ directory is never mentioned (creating a file in a nonexistent directory fails), and obtaining the session_id is unstated. No validation cap applies — appending a section to a markdown log is neither destructive nor batch — and the sequence is far more explicit than anchor 3's "steps listed but checkpoints missing".

4 / 5

Progressive Disclosure

This is a single-purpose skill under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and nothing inlined that belongs in a separate file; the skill itself is the reference target for other logs. Per the rubric's simple-skill note ("for skills under 50 lines with no need for external references, progressive disclosure can score 5 with just well-organized sections"), the well-organized steps, example block, and checklist earn a 5; there are no organization gaps that would justify anchor 4.

5 / 5

Total

18

/

20

Passed

Description

56%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 conveys a single, concrete purpose (concise work logging with references to a dated file), but it is written in second-person voice, carries meta-explanation about intent rather than capabilities, and provides no "Use when..." trigger guidance. Distinctiveness is good, with only minor overlap risk around the common word "log".

Suggestions

Rewrite in third-person voice without "you" (e.g., "Logs the work segment since the last worklog entry to WORKLOG/YYYYMMDD.md...") to avoid the second-person specificity penalty.

Add an explicit trigger clause, e.g., "Use when the user asks to log work, update the worklog, or record what was done in a session."

Trim the intent/philosophy sentences ("The intent of this worklog is not to be exhaustive... This is the progressive disclosure principle") and add natural synonyms such as "record" or "journal" to sharpen capability language and trigger coverage.

DimensionReasoningScore

Specificity

The description names one concrete action — "Log the work segment that you did after the last work log until now in a log file at WORKLOG/YYYYMMDD.md where YYYYMMDD is based on today's date" — which is anchor-3 territory (domain plus 1-2 concrete actions, not comprehensive; no "several specific actions" for anchor 4). It is additionally written in second person ("the work segment that you did"), which the rubric penalizes by reducing the specificity score by 1, yielding 2. It sits above anchor 1/2's pure vagueness because the file path and date-based naming are concrete, but the single action, the meta-padding about intent ("The intent of this worklog is not to be exhaustive and super detailed... This is the progressive disclosure principle"), and the voice penalty hold it at 2.

2 / 5

Completeness

The "what" is clear and concrete (log a work segment to WORKLOG/YYYYMMDD.md as a concise description plus references to detailed documents), but there is no "Use when..." clause or equivalent trigger guidance — the only temporal language ("after the last work log until now") describes the log's content scope, not when to invoke the skill. Per the guideline, a missing "Use when..." clause caps completeness at 3. Not anchor 2 because the "what" is not vague.

3 / 5

Trigger Term Quality

Natural keywords a user would actually say are present: "Log the work segment", "work log", "worklog", and "log file", covering both the "worklog" and "work log" spellings. This matches anchor 4 ("good keyword coverage; a few natural terms missing") — common variations like "record", "journal", "changelog", or "session summary" are absent, so it is not anchor 5, but it clearly exceeds anchor 3's single-keyword example ("Works with PDF files").

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — appending timestamped sections to WORKLOG/YYYYMMDD.md — distinct from most skills, but "log" is a broadly used trigger word (error logs, server logs, changelogs, journals), creating minor overlap risk with closely related logging/journaling skills. This matches anchor 4 ("mostly distinct; minor overlap risk") rather than anchor 5, since no explicit trigger phrasing narrows when this specific worklog skill applies.

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

pchalasani/claude-code-tools

Path

plugins/workflow/skills/log-work/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.