CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

summarize-hour

Use when the work-journal app asks to summarize one hour of recorded activity into a narrative, a timeline, detailed notes, a main focus, and action items.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is summarize-hour in chandler767/WorkJournal

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 exemplary instruction-only skill body: precise, actionable, and free of padding, with every behavioral rule (input contract, output schema, edge cases, anti-hallucination constraints) stated explicitly. The only improvement available is trimming the small amount of duplicated guidance in the two rules sections.

Suggestions

Merge the duplicated invention guards: keep "Never invent anything the input does not contain" in one place instead of restating it as "Never invent meetings, people, or action items that the input does not support".

Tighten the "Be concrete" paragraph by letting the good/bad example pair ("Edited Capture.swift...", not "Worked on code") carry the point, dropping the preceding generic sentence.

DimensionReasoningScore

Conciseness

The body is lean — rules, an exact input field spec, per-field semantics, and the output schema — with no explanations of concepts Claude already knows. It stops short of anchor 5 only because of small duplications: "Never invent anything the input does not contain" restates the earlier "Never invent meetings, people, or action items that the input does not support", and "Prefer specifics over generic phrasing" partly restates "Be concrete".

4 / 5

Actionability

Guidance is fully executable: field-by-field input spec, a copy-paste literal for the empty hour ("{\"narrative\":\"\",\"timeline\":[],...}"), a concrete good/bad pair ("Edited Capture.swift to recheck exclusions before screenshots", not "Worked on code"), worked correction semantics ("the person called Speaker 2 at 15:00 is Maya"), and a complete JSON schema for the reply.

5 / 5

Workflow Clarity

A single-task skill whose action is unambiguous: read only the named input file ("If the file is long, read it in parts (offset/limit) until you have read all of it, then answer"), then reply with one JSON object. Edge cases (empty hour, boundary times, merging, corrections) are explicitly resolved, and the read-only single-shot nature means no destructive/batch validation is required.

5 / 5

Progressive Disclosure

The skill is self-contained with well-organized sections (Rules, Input, field rules, Output schema) and roughly 38 lines of prose, so no external references are needed; the inline output schema is the skill's contract, not bulk content that belongs in a separate file. Well-organized sections with no bundle files fully satisfy the simple-skill case.

5 / 5

Total

19

/

20

Passed

Description

92%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 tight, well-formed description for a headless single-purpose skill: it states exactly what it produces (five named deliverables) and exactly when it fires (the work-journal app asking for a one-hour summary), with no fluff or over-claims. The only gap is mild: no trigger synonyms beyond the primary phrasing.

Suggestions

Add one or two natural synonyms to the trigger clause (e.g., "...into a narrative, timeline, notes, main focus, and action items — an hourly recap of recorded activity") so users or prompts phrased as "recap my hour" also match.

Optionally hint at the input form ("from the hour's recorded segments, meetings, transcript, and OCR") to strengthen the what-clause without adding length.

DimensionReasoningScore

Specificity

"summarize one hour of recorded activity into a narrative, a timeline, detailed notes, a main focus, and action items" names five concrete deliverables that fully cover this skill's output surface with no vague language. It exceeds anchor 4 ("minor gaps in coverage") because the enumeration is complete for a single-purpose skill.

5 / 5

Completeness

"Use when the work-journal app asks to summarize one hour of recorded activity into ..." explicitly answers both when (the app asking for a one-hour summary) and what (the five enumerated deliverables) with concrete trigger phrasing. This matches anchor 5 rather than 4, where the "when" would be less explicit.

5 / 5

Trigger Term Quality

Natural terms are present ("summarize", "one hour", "recorded activity", "timeline", "action items", "work-journal app") and would be said by a user or invoking app, but synonyms such as "recap" or "hourly summary" are missing. Good coverage, short of the synonym-level completeness of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"work-journal app", "one hour", and "recorded activity" carve a clear niche unlikely to collide with other skills, and sibling skills (e.g., day-level summaries) are excluded by the one-hour scope. Minimal conflict risk, matching anchor 5.

5 / 5

Total

19

/

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

chandler767/WorkJournal

Path

.tessl/plugins/local/work-journal/skills/summarize-hour/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.