CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

task-engineering-with-taskfile

Create, update, run, publish, and troubleshoot Go Task Taskfiles and Slurpyb pi-taskfile workflows, agent configurations, and helper extensions. Use for native task composition, variables and includes, build freshness, Pi invocation and Markdown inputs, package distribution, or execution failures.

Quality

82%

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

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 tightly written orchestration skill: a lean, disciplined five-step workflow with real validation and evidence-reporting steps, plus clearly signaled one-level-deep references. The main defects are three dangling references (examples/ and GENERATION.md are missing from the bundle), an inline version pin, and the absence of an explicit fix-and-retry loop.

Suggestions

Add the missing examples/ directory (README.md and ordered.yml) and GENERATION.md, or remove those three links from the References section — the body calls examples/ordered.yml 'the smallest starting point', so a reader following it currently hits nothing.

Move the version-sensitive note 'Existing Task examples target 3.54.0' into a dedicated versioning/compatibility reference (or the existing Taskfile-versions link) so the SKILL.md body stays date-stable.

Close the feedback loop between steps 4 and 5: state what to do when the disposable check exposes the feared failure (fix, re-run the single branch, then report), rather than only reporting 'the artifact, observed result, and limits'.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with no padding or explanations of concepts Claude already knows ('Give leaf commands explicit inputs and effects', 'sh can execute during --dry'). The inline version pin 'Existing Task examples target 3.54.0' is time-sensitive information not placed in a deprecated/old-patterns section, which the guidelines penalize, keeping this just below anchor 5.

4 / 5

Actionability

Guidance is mostly executable with concrete commands and flags ('Inspect existing changes and task --version', 'check pi --version', 'sh can execute during --dry', 'Use includes for reuse, cmds task calls for order'). Per the instruction-skill scoring note the absence of full code examples inline is acceptable, but some directives remain at policy level ('Give leaf commands explicit inputs and effects') without a concrete illustration, so anchor 4 fits better than 5.

4 / 5

Workflow Clarity

The five-step sequence (locate consumer → read contract → compose smallest change → exercise boundary → close with evidence) is clear, with explicit completion criteria ('Done when the changed behavior has an owner...') and a genuine validation step ('choose a disposable check that could expose the feared failure'). It falls short of anchor 5 because there is no explicit fix-and-retry feedback loop after a failed check, and the dense phrasing slightly obscures some checkpoints.

4 / 5

Progressive Disclosure

Structure is good: a compact overview, a routing rule ('Read only the branches needed for the current decision; follow another when the boundary changes'), and 12 well-signaled one-level-deep references with per-link descriptions. However, three of the referenced paths — examples/README.md, examples/ordered.yml, and GENERATION.md — do not exist in the bundle, so navigation breaks exactly where the body points for the smallest starting point ('[ordered calls](examples/ordered.yml) is the smallest starting point').

4 / 5

Total

16

/

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 with a full lifecycle 'what' and an explicit, concrete 'Use for' clause naming the domain's real trigger terms. It is anchored in distinctive product names (Go Task, pi-taskfile) with only minor generic-word collision risk from 'task' and 'execution failures'.

DimensionReasoningScore

Specificity

Lists several specific actions tied to named artifacts ('Create, update, run, publish, and troubleshoot Go Task Taskfiles and Slurpyb pi-taskfile workflows, agent configurations, and helper extensions'). The verbs are somewhat generic lifecycle terms compared to anchor 5's artifact-level actions, and concrete behavior per area (e.g., what 'update' involves) is left to the when-clause, so anchor 4 is the best fit.

4 / 5

Completeness

Clearly answers both parts: the what is the explicit lifecycle ('Create, update, run, publish, and troubleshoot...'), and the when is an explicit 'Use for' clause with concrete triggers ('native task composition, variables and includes, build freshness, Pi invocation and Markdown inputs, package distribution, or execution failures'). This matches anchor 5 directly; anchor 4 would require a vaguer when-clause.

5 / 5

Trigger Term Quality

Good keyword coverage with the natural product names users would say: 'Go Task', 'Taskfiles', 'pi-taskfile', 'variables and includes', 'build freshness', 'package distribution', 'execution failures'. A few natural terms are missing — 'task runner', 'Taskfile.yml', and generic build-tool phrasing — so it sits between anchors 4 and 5, closer to 4.

4 / 5

Distinctiveness Conflict Risk

Mostly distinct: 'Go Task Taskfiles' and 'Slurpyb pi-taskfile' name a clear niche with minimal overlap against unrelated skills. Minor conflict risk remains because the generic word 'task' and the trigger 'execution failures' could plausibly match task-list/todo or generic failure-triage skills, fitting anchor 4 rather than 5.

4 / 5

Total

17

/

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: 3 missing

Warning

Total

15

/

16

Passed

Repository

slurpyb/pi-taskfile

Path

skills/task-engineering-with-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.