CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cron-scheduler

Use this skill when the user wants to schedule recurring tasks, convert natural language schedules to cron expressions, or manage APScheduler jobs.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A solid, highly actionable skill body: complete, runnable code for NL-to-cron parsing and APScheduler job management with sensible defaults and real error handling. Its weaknesses are modest — no validation of the parsed expression before scheduling a recurring job, a small amount of content Claude already knows (standard cron table), and a hardcoded model version that will age.

Suggestions

Add a validation step before scheduling a recurring job — e.g., check that parse_schedule returned a cron_expression (handle the empty-dict fallback) and confirm the interpreted schedule before calling scheduler.add_job.

Trim or relocate the Quick Reference table of standard cron expressions; Claude already knows cron syntax, so those tokens are better spent on project-specific conventions.

Replace the hardcoded "claude-opus-4-6" model string with a current model identifier or a configurable value so the skill does not go stale.

DimensionReasoningScore

Conciseness

The body is dominated by lean executable code where comments earn their place ("misfire_grace_time=60, # allow 60s late execution", "coalesce=True, # don't stack up missed runs"), but there are minor trims available: the Overview paragraph repeats the frontmatter description, the Quick Reference table restates standard cron syntax Claude already knows, and "model=\"claude-opus-4-6\"" embeds time-sensitive version info outside any deprecated/old-patterns section. Fits the anchor for efficient content with minor instances that could be trimmed; not 5 because of those items, not 3 because there is no padded conceptual explanation.

4 / 5

Actionability

Everything is fully executable and copy-paste ready: a complete parse_schedule with the full tool schema, add_cron_job/remove_job/list_jobs implementations, and concrete usage examples ("add_cron_job(\"daily-report\", daily_report, \"every day at 8am\", timezone=\"America/New_York\")") with expected outputs shown in comments. Matches the anchor for fully executable code whose examples cover the common cases; not 4 because there are no material gaps.

5 / 5

Workflow Clarity

The sections give a clear progression — parse natural language, build a CronTrigger, add the job, then manage (list/remove) — with real error handling present (try/except in remove_job, misfire_grace_time/coalesce on add_job). However, there is no validation checkpoint before a recurring job is registered: an empty parse_schedule result ("{}") would raise a KeyError on "parsed[\"cron_expression\"]", and no confirm-the-parsed-expression step exists. Fits the anchor for a clear sequence with most checkpoints present and minor validation gaps; not 3 because the sequence and error handling are solid, not 5 because explicit validate/confirm steps are absent.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all content lives in one file with well-organized sections (Overview, Natural Language to Cron, APScheduler Integration, Example Jobs, Quick Reference). At roughly 140 lines it exceeds the under-50-line simple-skill exception that would allow a 5 on section organization alone, and the Quick Reference table and example jobs could plausibly be split into a separate reference file. Fits the anchor for good structure with most content appropriately placed and minor organization gaps; not 5 because the single-file layout is slightly over what an overview-first structure would keep inline.

4 / 5

Total

17

/

20

Passed

Description

83%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 strong description: it uses third person, states an explicit "Use this skill when..." trigger with three concrete capabilities, and anchors on distinct terms like cron and APScheduler. The main gaps are missing natural synonyms ("periodically", "every day at") and unmentioned job-management details like listing, removal, and timezones.

Suggestions

Add natural trigger synonyms such as "run tasks periodically", "every day/week at a specific time", or "scheduled jobs" so users' phrasings match more often.

Mention job listing/removal and timezone-aware scheduling to close the coverage gaps in the what-clause.

DimensionReasoningScore

Specificity

Names three concrete actions — "schedule recurring tasks", "convert natural language schedules to cron expressions", "manage APScheduler jobs" — matching the anchor for several specific actions with minor gaps in coverage (no mention of listing/removing jobs, timezone handling, or error handling). Not 5 because coverage is not comprehensive; not 3 because it goes well beyond 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both questions: the what is the three named capabilities, and the when is stated directly as "Use this skill when the user wants to schedule recurring tasks..." with concrete trigger phrases. Matches the anchor that clearly and explicitly answers both what AND when; not 4 because the when-clause is explicit rather than vague or only implied.

5 / 5

Trigger Term Quality

"schedule recurring tasks", "cron expressions", and "APScheduler" are natural terms a user would say, giving good keyword coverage; a few natural variations are missing ("run periodically", "every day at", "automate", "scheduled jobs"). Fits the anchor for good coverage with a few natural terms missing, short of the comprehensive synonym-level coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

"cron expressions" and "APScheduler" carve a distinct scheduling niche, but "schedule recurring tasks" is broad enough to overlap with generic reminder or task-automation skills. Fits the anchor for mostly distinct with minor overlap risk; not 5 because the recurring-task phrasing lacks a fully distinct trigger set.

4 / 5

Total

17

/

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

ProwlrBot/prowlr-marketplace

Path

external/community/cron-scheduler/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.