CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gardener-tasks

How to write, change and check Gardener tasks (.gardener/tasks/*/TASK.md), the AI maintenance tasks this repository runs from GitHub Actions. Use before creating or editing anything under .gardener/.

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a high-quality reference skill: every rule is stated as an exact key, value, or command, the workflow includes a generate-validate-fix loop plus draft-mode trialing, and the template is copy-paste ready. Structure and navigation are strong. The only notable improvements are trimming a few wordy passages and considering splitting the trigger/effect/limit tables into reference files to shorten the always-loaded body.

DimensionReasoningScore

Conciseness

The body is dense domain-specific reference material (exact keys, allowed values, constraints Claude cannot know) with essentially no explanation of known concepts. A few passages could be trimmed — the long message.send bullet with emoji rules and the "Who a run may act on" prose — so it stops just short of the lean-everywhere anchor.

4 / 5

Actionability

Fully executable throughout: the pinned command "npx @scuffi/gardener@0.1.22 generate", a complete copy-paste TASK.md template with real frontmatter, per-key allowed values (e.g. "runtime-seconds | 30–21,000"), a worked effects example with YAML, and "gh workflow run gardener-<id>.yml -f issue=<n>". Common cases are covered by the template and the pull-request-update walkthrough.

5 / 5

Workflow Clarity

The Workflow section is a clear 4-step sequence with an explicit validation feedback loop ("Fix every error generate prints and read its warnings. Repeat until it succeeds") and a safe trial path ("Set draft: true, generate and merge… runs only by hand"). Checkpoints for the risky generated-file changes are explicit ("Never hand-edit generated files").

5 / 5

Progressive Disclosure

Well-organized single file: a Files overview, Workflow, Template, then reference sections (Frontmatter, Triggers, Tools, Effects, Network, Limits) cross-linked with anchors. However, all reference tables are inlined in one ~295-line SKILL.md with no split into separate reference files, which is a minor organization gap against the overview-plus-references ideal.

4 / 5

Total

18

/

20

Passed

Description

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

The description follows best practice closely: concrete verbs, an exact file-path trigger, an explicit "Use before…" clause, and a tightly defined niche. It is concise while covering what, when, and for which files. The only weakness is that it omits a couple of secondary capabilities (trial runs, the generate workflow), which keeps specificity just below full marks.

DimensionReasoningScore

Specificity

Lists three concrete lifecycle actions ("write, change and check") on a precisely named artifact (".gardener/tasks/*/TASK.md") and defines what the tasks are ("the AI maintenance tasks this repository runs from GitHub Actions"). Not 5 because minor capabilities are unmentioned (trying/running tasks, the generate-and-commit flow); well above the 1-2-action level of 3.

4 / 5

Completeness

Explicitly answers both questions: what ("How to write, change and check Gardener tasks…") and when ("Use before creating or editing anything under .gardener/") with a concrete trigger phrase. Not 4 because the when-clause is explicit and path-specific rather than merely present.

5 / 5

Trigger Term Quality

Covers the natural terms a user would actually say or see: "Gardener tasks", the file path ".gardener/tasks/*/TASK.md", "GitHub Actions", and the directory-scoped "anything under .gardener/", plus the synonym gloss "AI maintenance tasks". No natural keyword for this niche is missing, matching the comprehensive-with-extensions anchor.

5 / 5

Distinctiveness Conflict Risk

A clear niche (repository-specific AI maintenance tasks declared in .gardener/) with path-scoped triggers means it would not fire for any other skill. Conflict risk is minimal.

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

cloudflare/agents

Path

.gardener/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.