CtrlK
BlogDocsLog inGet started
Tessl Logo

task-reminder

Organize scattered tasks into actionable lists and generate daily/weekly/deadline reminder plans when you need a structured schedule and exportable outputs (MD/CSV), with optional system notifications.

56

Quality

70%

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 ./scientific-skills/Other/task-reminder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 core operational content (When to Use, Example Usage, Implementation Details) is strong and executable, but it is buried under ~70 lines of generic validation/safety boilerplate that dilutes the skill, and the duplicated validation sections give conflicting expected outputs.

Suggestions

Cut the generic boilerplate sections (Required Inputs, Output Contract, Validation and Safety Rules, Failure Handling, Deterministic Output Rules, Completion Checklist) — they restate universal behavior Claude already follows and consume context without adding skill-specific knowledge.

Merge "Validation Shortcut" and "Quick Validation" into one section, and fix the conflicting expected output: Quick Validation claims "Result file: task_reminder_result.md" while the actual documented outputs are reminders.md and reminders.csv (also contradicted by the Output Contract section's "prefer task_reminder_result.md").

Replace the abstract "Recommended Workflow" steps with the concrete sequence already implied by the examples (1. run `python scripts/task_reminder.py --help` to validate; 2. build input.json per the schema; 3. run `python scripts/task_reminder.py --json input.json`; 4. verify reminders.md/reminders.csv were written), optionally adding a short sample of each output file's format.

DimensionReasoningScore

Conciseness

Noticeably verbose: the entire back half (Required Inputs, Recommended Workflow, Output Contract, Validation and Safety Rules, Failure Handling, Deterministic Output Rules, Completion Checklist) is generic policy boilerplate ("Do not fabricate... findings", "Keep the output safe, reproducible") that adds nothing Claude doesn't already know. "Quick Validation" also duplicates "Validation Shortcut" verbatim (same command twice), matching anchor 2's 'several unnecessary explanations or padded sections' rather than anchor 3's 'some unnecessary explanation'.

2 / 5

Actionability

Concrete, executable guidance throughout: exact commands ("python scripts/task_reminder.py --help", "python scripts/task_reminder.py --json input.json"), a complete copy-paste-ready JSON input example, and a well-specified input schema with defaults. Minor gaps — no sample of the generated reminders.md/reminders.csv contents and interactive mode behavior is only named — keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The practical sequence (validate with --help, run with JSON input, check reminders.md/reminders.csv) and validation checkpoints are present, but "Recommended Workflow" is abstract boilerplate ("Select the documented execution path and prefer the simplest supported command") and the two validation sections contradict each other — Quick Validation's expected output ("Result file: task_reminder_result.md") conflicts with the documented reminders.md/reminders.csv outputs. Sequence exists but checkpoints are muddled, matching anchor 3; not 2 because concrete executable steps and validation commands are genuinely present, and this is not a destructive/batch skill so no hard cap applies.

3 / 5

Progressive Disclosure

Sections are well-organized with clear headers, and both referenced bundle paths (scripts/task_reminder.py, scripts/validate_skill.py) exist in the actual bundle structure. The inlined Implementation Details (input schema, modes, outputs) are borderline-acceptable for a single-purpose script but push it past a lean overview, matching anchor 4's 'good structure; most content appropriately placed; minor organization gaps' rather than anchor 5's fully split structure.

4 / 5

Total

13

/

20

Passed

Description

75%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 solid description with concrete actions, good natural keywords, and an explicit when-clause, held back from the top band by second-person voice in the trigger clause and 'when' phrasing that describes a need-state rather than concrete user trigger phrases.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Organize scattered tasks into actionable lists", "generate daily/weekly/deadline reminder plans", "exportable outputs (MD/CSV)", "optional system notifications" — which is comprehensive coverage (anchor 5). However, the second-person clause "when you need a structured schedule" violates the third-person voice rule, applying the mandated -1 penalty: 4.

4 / 5

Completeness

Both 'what' (organize tasks, generate daily/weekly/deadline plans, export MD/CSV) and 'when' ("when you need a structured schedule and exportable outputs (MD/CSV)") are explicitly present. Not anchor 5 because the 'when' clause describes a need-state rather than concrete user trigger phrases (e.g., 'when the user mentions tasks, deadlines, or reminders'), and not anchor 3 because the 'when' is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "tasks", "reminder", "daily", "weekly", "deadline", "schedule", "notifications" are phrases users would naturally say. A few common variations are missing (e.g., "to-do list", "calendar", "plan"), matching anchor 4 rather than the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The reminder-plan generation niche with daily/weekly/deadline modes and MD/CSV export is mostly distinct with clear triggers. Minor overlap risk exists with general scheduling, to-do, or calendar skills, matching anchor 4 rather than the minimal-conflict niche of anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
aipoch/medical-research-skills
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.