CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-management

Load to plan a cycle, audit issues, build a roadmap, or decompose research into issues.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/project-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 layer with concrete commands, literal templates, and validation gates for batch tracker mutations. Its weaknesses are length relative to an overview (duplicated taxonomy/project-map JSON and paragraph-length rule detail) and a bundle in which most cited workflow, template, and schema files are absent.

Suggestions

Replace the inlined taxonomy and project-map JSON blocks with pointers to references/labels.md and references/project-map.md, keeping only the routing summary inline.

Move the Post-merge Done-when rule detail (~line 129) into the workflow or reference file that owns post-merge verification, keeping one summary line here.

Ensure the bundle ships the cited workflows/, templates/, and schemas/ files (or prune dead citations) so the commands table and Contracts table resolve for a reader.

DimensionReasoningScore

Conciseness

The body is dense and information-rich with no filler explaining known concepts, but at ~33 KB it is overlong for an overview: the taxonomy and project-map JSON blobs duplicate content held in references/labels.md and references/project-map.md, and the ~450-word Post-merge paragraph is rule detail that belongs in the workflow files it cites. Not 2: most sections earn their tokens; not 4: the duplicated JSON and paragraph-length rule walls need tightening or moving.

3 / 5

Actionability

Concrete guidance throughout: a commands table with exact arguments, literal "<delegation_format>"/"<output_format>" templates with fill rules, exact CLI invocations ("issues update [ISSUE_ID] --attach [PATH]", "gh issue view [N] --repo [OWNER/REPO] --json body,comments"), and exact checkbox syntax. Not 5: no worked examples showing a filled template or a complete run end to end.

4 / 5

Workflow Clarity

Explicit ordering ("Run workflow sections in order. Skip only on an explicit **Skip if** condition") and validation checkpoints around batch mutations ("run the label preflight... any § Validation failure there halts before mutation"; "Verify every attachment and description write before reporting completion"), so the batch-operation cap does not apply. Not 5: the actual step-by-step sequences live in workflow files, and error-recovery loops at this level are mostly pointers (e.g. "A failed check follows orch § The Cycle").

4 / 5

Progressive Disclosure

Structure is good in intent — commands table, Contracts table, and one-level references that are clearly signaled — but most paths cited in the body (workflows/*.md, templates/*.md, schemas/*.md) do not exist in the bundle, so navigation breaks for the majority of links, and the inline project-map JSON duplicates references/project-map.md. Not 2: the sections, tables, and existing references are clearly organized and signaled; not 4: dead cited paths and inlined reference content are real organization gaps.

3 / 5

Total

14

/

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 compact, mostly specific description whose action list mirrors the skill's real commands, with natural trigger terms. Its main weakness is the missing explicit "Use when..." trigger clause, which caps completeness, plus a few absent synonyms.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to plan a cycle, audit or triage a backlog, build a roadmap, or break research down into issues."

Add natural synonyms users say for the same needs: "backlog", "triage", "break down work", "spike".

Mention the roadmap-create and research-spike/complete flows to close the coverage gap in the action list.

DimensionReasoningScore

Specificity

"plan a cycle, audit issues, build a roadmap, or decompose research into issues" names four concrete actions that mirror the commands table. Not 5: coverage has gaps (roadmap-create, research-spike/complete are absent) and "decompose research into issues" is less concrete than the rest; not 3: it lists several specific actions rather than only 1-2.

4 / 5

Completeness

The "what" is clear (four named capabilities), but there is no explicit "Use when..." clause; "Load to..." states purpose only, so the "when" is weakly implied. Per the judging guidelines, a missing 'Use when...' clause or equivalent caps completeness at 3.

3 / 5

Trigger Term Quality

"plan", "cycle", "audit", "roadmap", "research", "decompose" are terms a TPM user would naturally say. Not 5: common variations and synonyms (backlog, triage, break down work) are missing; not 3: keyword coverage is good, not merely partial.

4 / 5

Distinctiveness Conflict Risk

Tracker/TPM-specific triggers (cycle planning, issue audits, roadmap building) carve a clear niche among adjacent skills. Not 5: generic planning vocabulary leaves minor overlap risk with general planning or roadmap skills.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 28 missing, 9 suspicious

Warning

Total

13

/

16

Passed

Repository

vanillagreencom/kendex

Path

.agents/skills/project-management/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.