CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sniff-test

Run a lightweight, evidence-based "sniff test" on a single initiative (epic, project, or Tier-1 bet) to find where its clarity is insufficient for its stage in the Portfolio PDLC lifecycle, so you can drive the right investment/commit and derisking conversations. Best run pointed at where the initiative is managed (its folder/workspace, Confluence space, or Jira epic) or given its Lean Product Canvas plus a recent sponsor update; with little input it asks for context first. Use when pressure-testing an initiative before a Plan/Commit decision or Execute/Build commitment, checking whether a Lean Product Canvas and Discovery plan match the real risks, or coaching on leading indicators and risk-appropriate derisking. For multi-initiative board patterns, use the sniff-test-portfolio add-on.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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-architected instruction-only skill: a sequenced, checkpointed workflow with concrete rating scales, explicit evidence types, and an exemplary one-level-deep reference bundle cited at the point of use. Its one real weakness is repetition — the stage-verification imperative, the thin-input caveat, and the 'common language, not gates' framing each appear multiple times, and the 'How to Run Me' section is chattier than it needs to be.

Suggestions

State the stage-verification rule once (in 'Stage Is a Required, Verified Input') and have the workflow step and the Rules entry reference it in a few words instead of restating it — this alone would trim noticeable repetition.

Tighten 'How to Run Me' to a compact ranked input list plus one short paragraph on thin-input behavior; the conversational framing ('The cleanest way to run me', 'what helps most') carries tokens without adding guidance.

Add one short worked example of a well-formed flag (mismatch → evidence gap → the specific next conversation → go/no-go implication) to close the last actionability gap and anchor the output shape.

DimensionReasoningScore

Conciseness

The body is dense with framework-specific knowledge Claude does not already know (stage verification, watermelon, rubber-stamp, tiering) and contains no generic-concept padding, but it could be tightened: the stage-verification message is repeated three times ('Verify it against evidence before rating', workflow step 1 'Establish and verify the stage ... Flag any stage-vs-evidence mismatch', and the Rule 'Verify the stage before trusting it. A stale status label is itself a smell'), the thin-input caveat appears in both 'How to Run Me' and workflow step 0, and 'common language, not gates' is stated three times. The 'How to Run Me' section also carries conversational prose ('The cleanest way to run me...', 'Expect a longer, noisier flag list'). Not a 4 because the repetition and chattiness are more than minor trimming; not a 2 because everything explained is genuinely skill-specific rather than concepts Claude already knows.

3 / 5

Actionability

Concrete, followable guidance throughout: an explicit rating scheme ('Mark each Lean Product Canvas / risk dimension: clear / partial / question mark — and tag each as evidence-backed or opinion'), named verification evidence types ('downstream artifacts, shipped code/output, go-live state, git history, decision records'), per-step reference files, three defined output modes, and a specific next-step requirement ('Each flag carries a specific, small next conversation or derisking activity — not "do more discovery."'). Minor gaps keep it below 5: no worked example of a flag or a sample output shape, and no guidance on what to do when the stage cannot be determined at all. Not a 3 because the guidance is not pseudocode-like — an agent can execute it directly.

4 / 5

Workflow Clarity

The 7-step workflow (0-6) is clearly sequenced with explicit validation checkpoints: 'Verify it against evidence before rating' with named corroboration sources, 'flag the stage mismatch first — it can invalidate the entire clarity-vs-stage comparison', an inference-correction loop ('Separate what you heard from what you inferred ... say so and invite correction'), and a closing Quality Gates checklist covering ingestion, stage verification, evidence tagging, and output language. The destructive/batch validation cap does not apply (read-only analysis). Not a 4 because checkpoints are explicit rather than merely 'most present', and a checklist plus correction loop are both provided.

5 / 5

Progressive Disclosure

Clean overview-plus-references structure: the body keeps the operating model (questions, workflow, rules, gates) while the four detail files — all verified to exist — carry the per-dimension rubric, per-stage expectations, derisking matrix, and facilitation guidance. Each is cited at the exact workflow step where it is needed ('Use references/clarity-dimensions.md', 'Flag mismatches using references/lifecycle-clarity-rubric.md') and catalogued with one-line descriptions in a References section. References are one level deep: the cross-pointers between reference files (e.g. clarity-dimensions.md → lifecycle-clarity-rubric.md) are peer signposts, not buried content chains. Not a 4 because navigation is easy and nothing that belongs in a reference is inlined in the body.

5 / 5

Total

17

/

20

Passed

Description

86%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, information-dense description with explicit what/when triggers, rich natural synonyms, and clear sibling-skill boundary routing. Its main flaws are a second-person slip ('so you can drive...') that costs it the required third-person voice, and slightly incomplete action coverage relative to what the body actually does (stage verification, watermelon hunting).

Suggestions

Rewrite in consistent third person to remove the second-person clause — e.g. 'Run a lightweight, evidence-based "sniff test" ... so the right investment/commit and derisking conversations happen before money is committed' instead of 'so you can drive...'.

Enumerate the remaining concrete capabilities for fuller specificity: verifying the claimed stage against evidence (git history, shipped output, decision records), tagging each clarity rating as evidence-backed vs. opinion, and naming watermelon / stage-mismatch smells.

Consider adding one natural trigger phrase for the 'readiness check' scenario (e.g. 'go/no-go' or 'readiness review before a commit decision') since it is a distinct use case users would name.

DimensionReasoningScore

Specificity

Base 4: the description names several concrete actions ('find where its clarity is insufficient for its stage in the Portfolio PDLC lifecycle', 'drive the right investment/commit and derisking conversations', 'asks for context first') plus specific inputs (folder/workspace, Confluence space, Jira epic, Lean Product Canvas, sponsor update), with minor coverage gaps (no mention of stage verification or output). Reduced by 1 per the judging guideline because it slips into second person ('so you can drive the right investment/commit and derisking conversations'), violating the required third-person voice. Not a 2 because the domain is clearly named and multiple concrete actions and input types are listed, well beyond 'actions are minimal or generic'.

3 / 5

Completeness

Explicitly answers both questions: what ('Run a lightweight, evidence-based "sniff test" on a single initiative ... to find where its clarity is insufficient for its stage') and when ('Use when pressure-testing an initiative before a Plan/Commit decision or Execute/Build commitment, checking whether a Lean Product Canvas and Discovery plan match the real risks, or coaching on leading indicators...'). The 'Use when' clause is present with concrete trigger phrases, and input expectations plus add-on routing are also stated. Not a 4 because the 'when' is not merely adequate — it enumerates three concrete trigger scenarios.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with explicit synonyms: 'a single initiative (epic, project, or Tier-1 bet)', 'pressure-testing an initiative', 'Plan/Commit decision or Execute/Build commitment', 'Lean Product Canvas', 'Discovery plan', 'leading indicators', 'risk-appropriate derisking', 'Confluence space, or Jira epic'. A user inside this framework would naturally say nearly all of these when they need the skill, and the synonym enumeration covers the common variations. Not a 4 because no significant natural phrasing is missing for this domain — even sibling routing ('multi-initiative board patterns') is phrased as a user would say it.

5 / 5

Distinctiveness Conflict Risk

A clear niche with distinctive framework vocabulary ('sniff test', 'Lean Product Canvas', 'Plan/Commit', 'Portfolio PDLC') and explicit boundary routing ('For multi-initiative board patterns, use the sniff-test-portfolio add-on'), which defuses the closest conflict. Not a 5 because within the same framework family there are closely related skills (the portfolio add-on, and the intent-framing-chooser referenced only in the body), and a generic request like 'review my initiative' could still pull this in over a sibling. Not a 3 because the enumerated artifacts and stages make overlap with unrelated skills unlikely.

4 / 5

Total

17

/

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

yyeret/portfolio-pdlc

Path

skills/sniff-test/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.