CtrlK
BlogDocsLog inGet started
Tessl Logo

recurring-jobs

The legacy manage-jobs compatibility surface, job files under jobs/, and cron scheduler internals. Use when maintaining manage-jobs integrations or debugging the scheduler.

64

Quality

80%

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/recurring-jobs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, well-organized reference skill: concrete tool actions, exact file paths, and clear positioning against the primary automations model, with no filler. Its gaps are a missing job-file/frontmatter example for the create action and a dense inlined MCP-security section that would benefit from being a separate reference.

DimensionReasoningScore

Conciseness

The body is efficient — no explanations of concepts Claude already knows, and the tool and key-file tables are dense with information. Not score 5 because passages like 'the shared runner, which resolves only that allowlist under the persisted creator/org request context and never stores or exposes OAuth tokens, URLs, or arbitrary proxy targets' are wordy and could be tightened; above score 3 since the padding is minor and mostly carries non-obvious domain facts.

4 / 5

Actionability

Concrete guidance throughout: exact tool/action pairs ('manage-jobs' with 'create', 'list', 'update'), exact paths ('packages/core/src/jobs/cron.ts', '/agent#jobs'), and specific mechanics ('bind the exact advertised mcp__<server>__<tool> names through mcpTools'). Not score 5 because it never shows a job-file example or the scheduling frontmatter fields, leaving the main creation flow without a copy-paste-ready specimen; well above score 3, which would be pseudocode-level hints.

4 / 5

Workflow Clarity

The 'How It Works' section lays out a clear five-step sequence from user request to saved job results, and the primary action (create via manage-jobs) is unambiguous. Not score 5 because there are no validation checkpoints or error-recovery guidance (e.g., what to do when a cron expression is invalid, though isValidCron is mentioned only in a file table); the destructive/batch cap of 3 does not apply since no such operations are instructed.

4 / 5

Progressive Disclosure

Good single-file structure: well-labeled sections, tables, and clearly signaled one-level-deep pointers to sibling skills ('automations', 'actions', 'delegate-to-agent') and key source files. Not score 5 because the 'Connected MCPs' section is dense security/behavioral detail inlined in the overview that could be split out, and the body runs past the ~50-line threshold where a single well-organized file alone earns top marks; comfortably above score 3, which expects structure with mis-signaled or missing separation.

4 / 5

Total

16

/

20

Passed

Description

78%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 focused, well-scoped description that explicitly states both what it covers and when to use it, with clear legacy-vs-primary positioning. Its main weakness is that it lists coverage areas rather than concrete capabilities (create/list/update recurring jobs), which limits specificity and leaves some natural synonyms like 'recurring' or 'scheduled' unused.

Suggestions

State the concrete capabilities, e.g. 'Create, list, and update recurring job files under jobs/ via the manage-jobs tool, and debug the cron scheduler behind them.'

Add the natural synonyms users say for this domain — 'recurring', 'scheduled', 'scheduled jobs' — so the description triggers on the product's own vocabulary, not just the legacy tool name.

DimensionReasoningScore

Specificity

The description names its domain concretely ("The legacy manage-jobs compatibility surface, job files under jobs/, and cron scheduler internals") but enumerates coverage areas rather than concrete actions like create/list/update jobs. It matches anchor 3 — domain plus 1-2 concrete items but not comprehensive — rather than 4, which requires several specific actions, or 2, which would leave actions entirely generic.

3 / 5

Completeness

It explicitly answers what ("legacy manage-jobs compatibility surface, job files under jobs/, and cron scheduler internals") and when ("Use when maintaining manage-jobs integrations or debugging the scheduler") with concrete trigger phrases. This matches the anchor-5 example structure; the 'when' clause is explicit and specific, so it is not score 4's weaker 'when'.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "manage-jobs", "jobs/", "cron", "scheduler", "integrations" are phrases a maintainer would actually say ("Use when maintaining manage-jobs integrations or debugging the scheduler"). Not score 5 because common synonyms like "recurring", "scheduled", or "scheduled tasks/automations" are absent; clearly above score 3, which expects only some relevant keywords with missing variations.

4 / 5

Distinctiveness Conflict Risk

The legacy framing ("The legacy manage-jobs compatibility surface") carves out a clear niche distinct from the primary automations model, so it is mostly distinct. Not score 5 because job/scheduler terminology overlaps with a sibling automations skill (the body confirms automations is the primary product model), leaving minor overlap risk; well above score 3's "could still overlap with similar skills".

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
BuilderIO/agent-native
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.