CtrlK
BlogDocsLog inGet started
Tessl Logo

project-workflow

Runs multi step work the way a careful senior engineer would. Triage before code, a short PRD in prds/, task.md kept current, docs synced after, and lessons recorded when a mistake repeats. Use when a task spans several files or steps, changes architecture, needs a plan the user can review, or when the user says "write a PRD", "plan this", "track this in task.md", or "what did we learn".

80

Quality

100%

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

100%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 well-crafted instruction-only skill body: a tight loop overview followed by sections of concrete rules, formats, copy-paste examples, and explicit verification discipline, with the bulky template appropriately externalized to a real reference file. Dependencies on sibling skills (project-docs, avoid-feature-creep) are clearly signaled and do not obscure the workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanations of what a PRD, git, or a changelog is; every section consists of rules, formats, or concrete examples. It matches the score-5 anchor ('every token earns its place') — the brief intro line and skip-guidance ('Skip this for one file fixes') are boundary rules, not padding, so it does not fall to 4.

5 / 5

Actionability

Guidance is fully executable: concrete file paths and layouts (prds/<slug>.md, task.md sections, prds/lessons.md, prds/archive/), specific commands ('git log --date=short', 'npx convex dev'), copy-paste-ready good/bad task entries, a lesson-line example, and a link to the real PRD template. As an instruction-only skill whose guidance is this specific, it matches the score-5 anchor; minor judgment calls like 'if the plan has a real choice in it' are inherent to the domain, not gaps.

5 / 5

Workflow Clarity

The six-step loop is clearly sequenced with explicit validation checkpoints ('Verify each step', 'An item moves to Completed after verification, not after the edit', the Never rule forbidding done-marking without the PRD verification step) and feedback loops for error recovery (triage ask-one-question-and-wait, 'Stop and re plan if the work stops making sense'). This is not a destructive or batch skill, so the workflow cap does not apply; it matches the score-5 anchor with checklist-style triage and Never sections.

5 / 5

Progressive Disclosure

The body is a concise overview organized into well-labeled sections, and the single detail-heavy artifact (the PRD layout) is correctly split into references/prd-template.md, which exists, is one level deep, and is clearly signaled with a markdown link. This matches the score-5 anchor for a clear overview with well-signaled one-level-deep references rather than 4, which presumes organization gaps.

5 / 5

Total

20

/

20

Passed

Description

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

An exemplary description: it names the concrete workflow steps and their artifacts, states both what the skill does and when to use it, and includes quoted natural-language trigger phrases users would actually say. The only mild flourish ('the way a careful senior engineer would') is brief and does not dilute the concrete content.

DimensionReasoningScore

Specificity

The description lists five concrete, specific actions with named artifacts: 'Triage before code, a short PRD in prds/, task.md kept current, docs synced after, and lessons recorded when a mistake repeats.' This comprehensively covers the skill's workflow, matching the score-5 anchor rather than 4, which is reserved for lists with minor coverage gaps.

5 / 5

Completeness

Both questions are answered explicitly and concretely: the 'what' is the triage → PRD → task.md tracking → docs sync → lessons loop, and the 'when' is a full 'Use when' clause with concrete trigger phrases ('when the user says "write a PRD", "plan this", ...'). This matches the score-5 anchor exactly; score 4 would require a less explicit 'when'.

5 / 5

Trigger Term Quality

It includes natural user phrasings in quotes: 'write a PRD', 'plan this', 'track this in task.md', and 'what did we learn', plus descriptive triggers like 'changes architecture' and 'spans several files or steps'. These are exactly the phrases a user would naturally say when needing this skill, with no jargon-only or generic filler; there are no meaningful synonyms left out for this domain.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (multi-step work management via PRDs, task.md, and a lessons file) and the quoted triggers ('write a PRD', 'track this in task.md', 'what did we learn') are distinctive enough that this is unlikely to fire for the wrong skill. It matches the score-5 anchor for clear niche and minimal conflict risk rather than 4, which presumes overlap with closely related skills.

5 / 5

Total

20

/

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
waynesutton/convexskills
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.