CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

taskfile

Authors, reviews, and diagnoses Task (go-task) automation in Taskfile.yml, Taskfile.yaml, included Taskfiles, and .taskrc.yml. Use for ordered or parallel workflows, typed inputs and CLI arguments, stale builds, reusable monorepo tasks, watch/CI failures, or remote Taskfile trust.

Quality

85%

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

70%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 body is a lean, well-sequenced workflow with strong validation guidance and no tutorial padding, and the references that do exist are substantive and well-organized. However, the bundle does not contain the docs/ snapshot, examples/ fixtures, or GENERATION.md that the body repeatedly directs the reader to, which undercuts both its actionability and its navigation structure.

Suggestions

Bundle the referenced examples/ fixtures (examples/README.md, examples/ordered-calls/Taskfile.yml) or remove those pointers and inline a minimal ordering example directly in the body, since the 'Ordered task calls' section currently points at a nonexistent file.

Bundle the docs/ snapshot and schema page (docs/index.md, docs/contents/reference/schema.md) or drop claims like 'the complete documentation snapshot is bundled' and 'check uncommon keys against the bundled schema', which currently reference missing files.

Move the version/date note ('Based on Task 3.54.0 documentation retrieved on 2026-10-21') into a dedicated versioning/compatibility section rather than the opening blockquote, keeping time-sensitive details out of the main flow.

DimensionReasoningScore

Conciseness

The body is lean and imperative with essentially no padding — "Task vars are template inputs, not environment exports to cmds" assumes competence and earns every token. Not 5 because the opening blockquote carries time-sensitive version/date information ("Based on Task 3.54.0 documentation retrieved on 2026-10-21") outside any versioning or compatibility section, which the rubric directs to penalize.

4 / 5

Actionability

Concrete keys and flags are named throughout ("deps", "task:" entries in "cmds", "status", "preconditions", "--dry", "--force", "--yes", "task --version"), but several of the most concrete instructions point to files missing from the bundle: "use the [ordered-calls Taskfile](examples/ordered-calls/Taskfile.yml)" and "check uncommon keys against the [bundled schema](docs/contents/reference/schema.md)" are dead references, and no inline Taskfile snippet compensates. This is missing key details rather than the minor gaps of the 4 anchor.

3 / 5

Workflow Clarity

The five-step workflow is clearly sequenced from "Identify the effective configuration" through "Verify the changed behavior", with explicit validation ("exercise a disposable fixture: successful execution, relevant failure, and actual outputs" including caching edge cases) and feedback loops ("expected versus observed outputs/failures", symptom-driven "correction, and recovery check"). The "Essential contracts" section functions as a checklist, and the closing explicitly rejects dry-run transcripts as evidence.

5 / 5

Progressive Disclosure

The in-body structure is good — a well-signaled one-level-deep <references> block where all six listed references/*.md files exist with verified anchors — but five referenced paths are absent from the actual bundle (docs/index.md, docs/contents/reference/schema.md, examples/README.md, examples/ordered-calls/Taskfile.yml, GENERATION.md), breaking navigation to the claimed "complete offline documentation" and "example catalog". Missing referenced files are a structural gap beyond the minor organization issues of the 4 anchor.

3 / 5

Total

15

/

20

Passed

Description

96%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: third-person voice, concrete actions tied to named file artifacts, and an explicit 'Use for' clause covering the tool's main sub-areas with natural trigger terms and file extensions. The only weakness is that a few generic scenario phrases ('watch/CI failures', 'stale builds') are not scoped to Task, creating minor overlap risk with general CI/build skills.

DimensionReasoningScore

Specificity

"Authors, reviews, and diagnoses Task (go-task) automation in Taskfile.yml, Taskfile.yaml, included Taskfiles, and .taskrc.yml" lists multiple concrete actions against specific named artifacts, and the when-clause enumerates seven concrete scenarios (typed inputs, stale builds, watch/CI failures, remote Taskfile trust) covering the tool's surface. Not 4 because coverage extends beyond a few actions into the domain's distinct sub-areas without abstraction or padding.

5 / 5

Completeness

The what-clause ("Authors, reviews, and diagnoses Task (go-task) automation in Taskfile.yml...") and an explicit "Use for ordered or parallel workflows, typed inputs and CLI arguments, stale builds..." when-clause both appear with concrete trigger phrases. Both questions are answered explicitly, matching the top anchor.

5 / 5

Trigger Term Quality

Includes the natural terms users of this tool actually say — "Taskfile.yml", "Taskfile.yaml", ".taskrc.yml", "go-task", "stale builds", "monorepo tasks", "typed inputs and CLI arguments" — with both synonyms and file extensions present. This matches the comprehensive-coverage anchor rather than the good-coverage anchor, which would require missing natural variations.

5 / 5

Distinctiveness Conflict Risk

"Task (go-task)" plus the Taskfile file names establish a clear niche with distinctive triggers, but generic phrases like "ordered or parallel workflows", "stale builds", and "watch/CI failures" carry minor overlap risk with closely related build/CI skills (Make, GitHub Actions). Not 5 because those unscoped generic terms could plausibly trigger the skill for non-Task problems; not 3 because the tool-specific file names dominate the description's identity.

4 / 5

Total

19

/

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

relative_links

Relative link issues: 7 missing, 2 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

slurpyb/pi-taskfile

Path

skills/taskfile/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.