CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product

Apply product thinking to platform work — DevEx audits, friction analysis, RFC/ADR drafting, incident communication, post-mortems, capacity planning, cost optimisation, and platform health review.

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 ./plugins/platform-skills/skills/product/SKILL.md

The canonical home for this skill is product in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured multi-topic command: exact RFC/ADR templates, a clearly sequenced interactive wizard, and concrete per-framework steps that mostly earn their tokens. The dominant defect is bundle integrity — four frameworks are deferred to references/platform-mindset.md, which is missing from the bundle, breaking both progressive disclosure and full actionability.

Suggestions

Create references/platform-mindset.md containing the SPACE dimensions, the friction audit table, the monthly cost loop, and the platform health checklist — the body instructs the agent to read it before responding, but the file is absent from the bundle.

Inline the minimal definitions the body invokes by name (SPACE dimensions, friction audit table rows, health checklist items) in SKILL.md so the skill degrades gracefully if the reference file is unavailable.

Add a lightweight self-check step for generated RFC/ADR documents (e.g., 'verify every section is filled and the alternatives table has at least two rejected options plus do-nothing') to close the validation gap.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and keeps each topic to terse numbered steps or a fill-in template; the interactive wizard is compact. Not 5 because a few lines restate general knowledge ('ADRs are immutable once accepted', 'Root cause (systemic, not human blame)') and the template-embedded coaching sentences could be slightly tightened; not 3 because padding is minor and localized.

4 / 5

Actionability

The RFC and ADR sections provide exact, copy-paste-ready document templates with tables, section order, and fill requirements, and the other topics name their key elements inline (friction categories 'onboarding / CI / secrets / environment / ownership', cost loop 'rightsizing → unused resources → showback'). Not 5 because the SPACE dimensions, the full friction audit table, and the health checklist are deferred to a reference file rather than defined, leaving minor execution gaps.

4 / 5

Workflow Clarity

The wizard flow is explicitly sequenced (Q1 topic → Q2 context), each topic framework is an ordered list, and checkpoints exist in 'Fill every section — no placeholders', the fallback rule for unmatched input, and the mandatory closing pair (Next step / Signal to watch). Not 5 because there are no explicit validate-and-fix feedback loops on the produced documents; these are drafting tasks, so no destructive/batch cap applies.

4 / 5

Progressive Disclosure

Section structure is good (wizard, per-topic headers, templates) and the single reference is clearly signaled and one level deep ('Read references/platform-mindset.md before responding'). However, that file does not exist in the bundle — the references/ directory is absent — so the disclosure chain is broken for the four frameworks that depend on it. Not 4 because a referenced path that fails to resolve is a navigation failure, not a minor organization gap; not 2 because the in-body structure itself is solid and nothing is deeply nested.

3 / 5

Total

15

/

20

Passed

Description

71%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 strong capability inventory: specific, concrete, and comprehensive about what the skill produces, in proper third-person voice. Its main weakness is the total absence of 'when to use' trigger guidance, which caps completeness, and a lack of synonym coverage that would help trigger matching.

Suggestions

Add a trigger clause, e.g.: 'Use when asked to draft an RFC or ADR, write an incident update or blameless post-mortem, audit developer experience or onboarding friction, or plan service capacity and costs.'

Include natural synonym spellings users actually type — 'developer experience' (not only 'DevEx'), 'postmortem' (single word), 'blameless retro' — to broaden trigger matching.

Lead with the most distinctive capability (platform-engineering product work) rather than the abstract verb phrase 'Apply product thinking', which adds trigger value only in combination with the topic list.

DimensionReasoningScore

Specificity

The description lists eight concrete deliverable types — 'DevEx audits, friction analysis, RFC/ADR drafting, incident communication, post-mortems, capacity planning, cost optimisation, and platform health review' — which comprehensively covers every topic in the skill body. Not 4 because there are no coverage gaps; every framework in the body is represented by a named action.

5 / 5

Completeness

The 'what' is clearly and concretely answered by the list of deliverables, but there is no 'Use when…' clause or equivalent explicit trigger guidance, capping this dimension at 3 per the judging guidelines. Not 4 because the 'when' is not even weakly implied — the description is purely a capability inventory.

3 / 5

Trigger Term Quality

Terms like 'RFC', 'ADR', 'incident', 'capacity planning', and 'friction' are exactly what users would naturally say. Not 5 because common synonyms are absent: 'developer experience' is only given as 'DevEx', 'post-mortems' omits the single-word 'postmortem' spelling used in the body, and no 'write/draft' phrasings users might use appear.

4 / 5

Distinctiveness Conflict Risk

The 'product thinking to platform work' framing carves a fairly distinct niche, and the enumerated topics disambiguate it from generic writing skills. Not 5 because individual topics (RFC drafting, post-mortems, cost optimisation) could plausibly have their own dedicated skills and trigger overlaps; not 3 because the combined platform-engineering scope is clearly distinguishable.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/product/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.