CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-health

Portfolio health dashboard and risk matrix analysis. Usage: /project-health <dashboard|risk> [options]

60

Quality

75%

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 ./.gemini/skills/project-health/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 genuinely lean, well-structured body with executable command examples and a complete input schema, undermined by references to scripts and another SKILL.md that are not part of the skill's bundle and would not resolve. The skill reads as a pointer stub for an external skill rather than a self-contained bundle.

Suggestions

Fix script paths to be bundle-relative (e.g., `scripts/project_health_dashboard.py`) and actually ship the two scripts in the skill's scripts/ directory.

Remove the "Skill Reference" section pointing to `project-management/skills/senior-pm/SKILL.md`, or replace it with resolvable in-bundle reference files (e.g., references/output-format.md).

State explicitly how the command maps to execution (e.g., 'Run the corresponding script with the provided data file'), including what to do if the input JSON fails validation.

DimensionReasoningScore

Conciseness

The ~45-line body is lean with zero padding: a one-line summary, two usage lines, one complete input schema, three example commands, and a compact script listing. No concepts Claude already knows are explained; every section earns its tokens, matching the 5 anchor 'Lean and efficient; assumes Claude's competence'.

5 / 5

Actionability

Concrete, copy-paste-ready commands ("/project-health dashboard portfolio-q2.json --format json") and a fully specified input JSON schema give strong executability. It falls short of 5 because the two scripts are referenced by repo-style paths ("project-management/skills/senior-pm/scripts/...") that do not exist in the skill's bundle, and no fallback or output description is provided.

4 / 5

Workflow Clarity

For this simple single-action skill the invocation is essentially unambiguous — pick dashboard or risk, supply a data file matching the documented schema, optionally set --format. It gets 4 rather than 5 because the mapping from the slash command to actually running the listed script is only implied (the body never states 'run the corresponding script'), and no guidance exists for handling malformed input.

4 / 5

Progressive Disclosure

Sections are well organized (Usage, Input Format, Examples, Scripts, Skill Reference), but the referenced detail files are broken: no scripts/, references/, or assets/ directories exist in the bundle, and both script paths plus the "Skill Reference" point to an external location (project-management/skills/senior-pm/...) that is unreachable. The structure exists but the disclosure chain dead-ends, fitting the 3 anchor 'Some structure but could be better organized; references present but not clearly signaled' more than the 4 anchor whose references resolve.

3 / 5

Total

16

/

20

Passed

Description

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

The description communicates a specific niche and deliverables concisely, but lacks any 'Use when...' trigger guidance, which caps its completeness and weakens its utility for skill selection. Action phrasing is nominal rather than verb-led, leaving it a notch below the reference good examples.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user asks for a portfolio health dashboard, project status overview, or risk matrix analysis.'

Lead with concrete verbs: 'Generate portfolio health dashboards and risk matrices from project data (schedule, budget, scope, quality, risks).' instead of bare nominalizations.

Include common synonyms users might say (project status, risk register, project oversight) to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Portfolio health dashboard and risk matrix analysis" names the domain and two concrete deliverables (health dashboard, risk matrix), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because the actions are bare nominalizations with no verb-led coverage (no 'generate', 'assess', 'track'), and not a 2 because two distinct, specific outputs are named rather than generic 'handles projects' language.

3 / 5

Completeness

The 'what' is clear (portfolio health dashboards and risk matrices), but there is no 'Use when...' clause or equivalent trigger guidance; "Usage: /project-health <dashboard|risk> [options]" documents invocation syntax, not when to reach for the skill. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 3, and the explicit invocation hint keeps it from dropping to 2.

3 / 5

Trigger Term Quality

Natural terms a PM would actually say are present: "Portfolio health", "dashboard", "risk matrix". It falls short of the 5 anchor because common variations and synonyms are missing (e.g., 'project status', 'risk register', 'project oversight', 'program health'), but exceeds the 3 anchor because the core keywords users would utter are all there.

4 / 5

Distinctiveness Conflict Risk

"Portfolio health dashboard and risk matrix analysis" occupies a clear PM/oversight niche unlikely to trigger for unrelated skills, but without explicit 'Use when' phrasing there is minor overlap risk with closely related reporting/status skills (e.g., a generic status-report skill), matching the 4 anchor 'Mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

14

/

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

alirezarezvani/claude-skills

Path

.gemini/skills/project-health/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.