CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

76

1.75x
Quality

65%

Does it follow best practices?

Impact

100%

1.75x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/conductor/skills/workflow-patterns/SKILL.md

The canonical home for this skill is workflow-patterns in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

62%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 content's core strength is an exceptionally clear, well-validated 11-step TDD workflow with concrete git and pytest commands and genuine error-recovery loops. Its weaknesses are verbosity — it re-explains TDD, conventional commits, and testing basics Claude already knows, with duplicated commit-format guidance — and a monolithic structure that inlines material better kept in reference files.

Suggestions

Cut sections that re-teach known concepts: the TDD step explanations (Steps 3-5 bullets), the conventional-commit type glossary, and the Performance Considerations / Best Practices checklists could be reduced to one-line reminders or removed.

Deduplicate the commit-message format, which is fully specified in both Step 8 and the Git Integration section — keep one canonical location and reference it.

Split reference-grade material (TDD Variations by Task Type, Handling Deviations, Checkpoint Verification Details) into separate files under references/ and link to them from SKILL.md, keeping the body focused on the 11-step lifecycle.

DimensionReasoningScore

Conciseness

The 620-line body re-teaches concepts Claude already knows — TDD basics ("Focus on making tests green, not perfection", "Avoid premature optimization", "Improve naming / Remove duplication"), conventional-commit type glossaries ("feat: New feature, fix: Bug fix..."), and testing hygiene ("Use fixtures to avoid redundant setup", "Mock slow external calls") — and explains commit-message format twice (Step 8 and the Git Integration section). This matches 'noticeably verbose; several unnecessary explanations or padded sections'; it is not 3 because the padding is extensive and systematic, not occasional.

2 / 5

Actionability

Much of the guidance is executable and copy-paste ready: `pytest --cov=module --cov-report=term-missing`, `git notes add -m "..."`, `git diff --name-only <last-checkpoint-sha>..HEAD`, plus concrete commit-message, plan.md, and git-notes templates. It is not 5 because sizable stretches (Quality Assurance Gates, Best Practices, Performance Considerations, Working with Existing Tests) are abstract bullet checklists rather than concrete commands or examples.

4 / 5

Workflow Clarity

The 11-step lifecycle is explicitly sequenced with validation at every phase — "Run tests - they should FAIL" / "they should PASS", the 80% coverage gate, "All tests must pass before proceeding", and "Do NOT proceed without explicit approval" — and a dedicated Error Recovery section provides feedback loops (revert to last GREEN state, checkpoint rejection remediation, blocked-task handling). This matches the top anchor: clear sequence, explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Headers and a numbered step sequence make the document navigable, but it is a monolithic single file with no bundle files at all — TDD Variations by Task Type, Handling Deviations, the QA-gates checklists, and Checkpoint Verification Details are all inlined when they clearly belong in separate reference files. This matches 'some structure but could be better organized; content that should be separate is inline'; it is not 4 because nothing is split out and the core workflow gets buried among reference-grade material.

3 / 5

Total

14

/

20

Passed

Description

67%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 solid description that explicitly covers both what the skill does and when to use it, with mostly distinct triggers anchored to a specific workflow. Its main weaknesses are missing natural synonyms (test-driven development, red-green-refactor) and capabilities stated at a fairly abstract level.

Suggestions

Add natural trigger synonyms such as 'test-driven development', 'red-green-refactor', or 'working from a track plan.md' so users phrasing the need differently still hit the skill.

State capabilities more concretely (e.g., 'write failing tests first, commit per task, record SHAs in plan.md') instead of the abstract 'implementing tasks according to Conductor's TDD workflow'.

DimensionReasoningScore

Specificity

The description names the domain ("Conductor's TDD workflow") and several concrete actions ("handling phase checkpoints, managing git commits for tasks, or understanding the verification protocol"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because phrases like "implementing tasks according to" remain somewhat abstract without naming the actual activities (writing failing tests, refactoring, recording SHAs).

4 / 5

Completeness

Both 'what' (implementing tasks, handling checkpoints, managing commits, verification protocol) and 'when' ("Use this skill when...") are explicitly present, matching the score-4 anchor. It is not 5 because the what and when blur into a single trigger list rather than a distinct capability statement paired with concrete trigger phrases.

4 / 5

Trigger Term Quality

"TDD workflow", "git commits", and "phase checkpoints" are terms users would naturally say, but common variations and synonyms are missing — no "test-driven development", "red-green-refactor", "plan.md", or "checkpoint" as a standalone trigger. It matches 'some relevant keywords but missing common variations or synonyms' rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

"Conductor's TDD workflow" with phase checkpoints and verification protocol carves a clear niche with mostly distinct triggers, matching 'mostly distinct; minor overlap risk'. It is not 5 because "managing git commits for tasks" could still overlap with generic commit-message or git-workflow skills.

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (624 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
Dicklesworthstone/pi_agent_rust
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.