CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workflow-patterns

Use this skill when implementing tasks according to Conductor's TDD workflow, handling phase checkpoints, managing git commits for tasks, or understanding the verification protocol.

56

Quality

71%

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 ./plugins/conductor/skills/workflow-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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-structured overview that uses progressive disclosure correctly — the SKILL.md body stays short and delegates the detailed 11-step TDD lifecycle to a real, one-level-deep reference file. Its weakness is that the body itself is mostly principles and triggers: the concrete sequence and executable guidance are entirely in the reference, leaving body-level actionability and workflow sequencing implicit.

Suggestions

Add a compressed inline outline of the TDD task lifecycle (RED → GREEN → REFACTOR → checkpoint → commit → update plan.md) so the core sequence is visible without opening the reference file.

Include one or two concrete artifacts in the body (e.g., the plan.md task status marks [ ]/[~]/[x] or a commit/notes command) to make the best practices immediately executable.

Trim the opening paragraph, which restates the frontmatter description, or fold the 'When to Use This Skill' bullets into it to remove redundancy.

DimensionReasoningScore

Conciseness

The body is short and skimmable with only minor over-explanation to trim — the opening sentence ('Guide for implementing tasks using Conductor's TDD workflow, managing phase checkpoints, handling git commits...') restates the frontmatter description, and the 'When to Use This Skill' bullets partially repeat it again. This matches the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than a 3, since the redundancy is limited to one duplicated sentence and one bullet list.

4 / 5

Actionability

The 'Best Practices' list gives concrete principles ('Small commits: One logical change per commit', 'Update plan.md right after task completion') but the body itself contains no commands, code, file paths, or step-level instructions — the executable detail (11-step lifecycle, test examples, commit commands) all lives in references/details.md. This sits between the 'minimal concrete guidance' anchor (2) and 'mostly executable guidance' (4): guidance is concrete in intent but incomplete without the reference file.

3 / 5

Workflow Clarity

The workflow sequence is not laid out in the body — the ordered 11-step red-green-refactor lifecycle lives in references/details.md, while the body offers unordered principles ('Never skip RED', 'Sequential phases: Complete phases in order', 'Wait for approval'). Checkpoints are referenced ('Never skip checkpoint verification', 'Quality gates: Check all gates before marking complete') but validation steps are implicit rather than sequenced, matching the 'steps present but checkpoints missing or implicit' anchor rather than 4.

3 / 5

Progressive Disclosure

The body is a concise overview with a single, clearly signaled one-level-deep reference: 'Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.' The referenced file exists at that path, is substantive (590 lines of worked patterns), and contains no nested skill references — exactly the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

15

/

20

Passed

Description

66%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 strongly triggered, domain-specific description with explicit 'when' guidance and several named activities, but it is entirely trigger-focused and never states what the skill actually provides. Adding a leading 'what' clause and a few more natural synonyms would round it out.

Suggestions

Add an explicit 'what' statement before the 'Use when' clause, e.g., 'Guides task implementation through Conductor's TDD red-green-refactor cycle, phase checkpoints, and git commit conventions.'

Include natural trigger variations users would say, such as 'test-driven development', 'red-green-refactor', 'plan file', or 'quality gates', to improve trigger coverage.

Name the concrete artifacts the workflow touches (plan.md tasks, phase checkpoints, commit notes) so the actions are as specific as the domain.

DimensionReasoningScore

Specificity

The description lists several specific actions — "implementing tasks according to Conductor's TDD workflow", "handling phase checkpoints", "managing git commits for tasks", "understanding the verification protocol" — which matches the 'several specific actions; minor gaps in coverage' anchor. It is not a 5 because the actions are activity-level rather than fully concrete (no artifacts like plan.md, test commands, or commit formats), and 'understanding the verification protocol' is comparatively generic.

4 / 5

Completeness

The 'when' is explicit and concrete ("Use this skill when implementing tasks... handling phase checkpoints... or understanding the verification protocol"), but the 'what' is never stated: the description is entirely a trigger list and never says what the skill does (e.g., 'Guides task implementation through...'). It sits between the 'only when present without what' anchor (2) and the 'both what and when' anchor (4), because the specific gerund activities weakly imply the subject matter.

3 / 5

Trigger Term Quality

It includes good natural keywords a user in this ecosystem would say — "TDD workflow", "phase checkpoints", "git commits", "verification protocol", "Conductor" — matching the 'good keyword coverage; a few natural terms missing' anchor. It misses common synonyms and variations such as "test-driven development", "red-green-refactor", "plan file", or "quality gates" that would push it to 5.

4 / 5

Distinctiveness Conflict Risk

The named niche "Conductor's TDD workflow" with "phase checkpoints" is a distinct, well-scoped domain, matching the 'mostly distinct; minor overlap risk with closely related skills' anchor. It is not a 5 because generic phrases like "managing git commits" and "verification protocol" could overlap with commit-message or general verification skills if those coexist.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

wshobson/agents

Path

plugins/conductor/skills/workflow-patterns/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.