CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

schedule-setup

Create a repo-defined schedule in a project's tessl.json from a plain-language description, optionally authoring the repo-local skill it runs. Use when the user wants to schedule a skill to run on a recurring cadence ("run X every morning", "kick off the report nightly", "schedule this weekly"), set up a recurring launch run, or add a `schedules` block to tessl.json. The user describes the task, cadence, and environment in plain words; this skill chooses the most readable supported schedule format, adds and validates the entry, and explains what happens on push. Not for one-off runs (use `tessl launch`) or for moving an existing UI/CLI schedule into the file (use schedule-migrate).

Quality

91%

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

The canonical home for this skill is tessl/schedule-setup

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-structured, actionable skill with an explicit validate-and-retry loop and thorough troubleshooting, appropriately split across two genuine reference files. Its main defects are a small amount of trimmable explanation and a dangling reference to a scripts/ directory that is absent from the bundle, which leaves the credential pre-flight branch of Section 3 unexecutable as written.

Suggestions

Ship the scripts/ directory (linear.sh, slack.sh, notion.sh) referenced in Section 3, or restate where those provider scripts should come from — the instruction currently points at files that do not exist in the bundle.

Trim passages that restate what Claude already knows (e.g., the JSON validity rules in Section 5) and the closing scope-justification paragraph in Section 3.

Show the actual `tessl skill new` invocation with its flags (or direct the reader to check its --help) instead of naming the command without arguments.

DimensionReasoningScore

Conciseness

Mostly efficient, Tessl-specific instruction with little generic padding, but a few passages could be trimmed: "Keep JSON valid: quote every key and string, no trailing commas, no comments" restates JSON basics, and Section 3's closing scope paragraph ("Checking every scheduled skill would require a platform launch-preflight hook and is outside this workflow") is justification Claude does not need to act. Not 3 because the bulk of the content (field rules, cap behavior, apply-time vs validate-time checks) is non-obvious and earns its place.

4 / 5

Actionability

Concrete, executable commands throughout (`tessl schedule --help`, `tessl env view --json --workspace <workspace> <environment>`, `tessl schedule validate`, `tessl schedule list --json --limit 100`) plus a complete JSON example and exact ref formats. Not 5 because Section 3 instructs copying provider scripts "verbatim and unmodified from this skill's `scripts/` directory" while no scripts/ directory exists in the bundle, and `tessl skill new` is named without showing its arguments. Not 3 because the guidance is otherwise copy-paste ready with specific error-recovery steps.

4 / 5

Workflow Clarity

A clearly sequenced seven-phase workflow (Preflight → Gather → Author → Choose key → Write → Validate → Explain next) with an explicit validation checkpoint and feedback loop: "Fix anything it reports and run it again until it passes", followed by a troubleshooting list for schedules that do not appear after push. Preflight checks (file existence, key collisions, current CLI surface) catch errors early.

5 / 5

Progressive Disclosure

The body is a decision workflow with the full field list and shorthand tables correctly split into two real, clearly signaled, one-level-deep references (references/schedules-block.md, references/cron-cadence.md), both of which exist in the bundle. Not 5 because the body also references "this skill's `scripts/` directory" (linear.sh, slack.sh, notion.sh) as the source for credential pre-flight scripts, and that directory does not exist in the bundle — a referenced path that cannot be resolved.

4 / 5

Total

17

/

20

Passed

Description

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

An excellent description: concrete what-and-when, natural quoted trigger phrases, third-person voice, and explicit boundary guidance that routes adjacent tasks to sibling skills. Slightly long, but every sentence carries information rather than padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: "Create a repo-defined schedule in a project's tessl.json", "optionally authoring the repo-local skill it runs", "chooses the most readable supported schedule format, adds and validates the entry, and explains what happens on push". Every stage of the task (create, author, format, add, validate, explain) is explicitly stated; nothing is left vague.

5 / 5

Completeness

Clearly answers both questions: the "what" is stated in the first sentence and elaborated concretely (choose format, add, validate, explain on push), and an explicit "Use when the user wants to schedule a skill to run on a recurring cadence..." clause gives concrete triggers. It even adds a "Not for..." boundary clause.

5 / 5

Trigger Term Quality

Includes literal quoted phrases users would naturally say ("run X every morning", "kick off the report nightly", "schedule this weekly") plus synonyms (schedule, cadence, recurring, nightly, weekly) and the concrete file target ("add a `schedules` block to tessl.json"). Coverage of natural terms is comprehensive for this domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche (repo-defined schedules in tessl.json) with explicit routing away from adjacent skills: "Not for one-off runs (use `tessl launch`) or for moving an existing UI/CLI schedule into the file (use schedule-migrate)". Minimal risk of triggering for the wrong skill.

5 / 5

Total

20

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

tesslio/product-plugins

Path

schedules/skills/schedule-setup/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.