CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tech-evaluation

Investigate a candidate library, dependency, or file format against a fixed question set and end with exactly one cited recommendation (adopt / keep_current / reject / needs_more_research) -- never "it depends." Validates the structured output against a JSON schema before writing a human-readable finding. Use when choosing between candidate npm packages, dependencies, or file formats for a specific integration point, or when a plan or ADR decision hinges on an unverified factual claim about a library (does it escape by default, does it bundle cleanly, is it maintained). Do NOT use for one-line version lookups, purely subjective preference calls with no verifiable claim, or a technology choice already settled by an existing ADR -- supersede the ADR instead. Triggers: "evaluate this library", "investigate this dependency", "compare X vs Y", "properly evaluate this technology", "which format should we use", "is this package maintained".

Quality

92%

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

85%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 strong, highly actionable body with an excellent validation-gated workflow and textbook progressive disclosure. The only weakness is redundancy: the core mindset points are repeated across the intro, Mindset, step 2, and Anti-Patterns sections, inflating token cost without adding information.

Suggestions

Merge the Mindset section into the intro (or trim it to points not already stated): the "verdict without a cited source is a guess / never it depends" framing appears in both places nearly verbatim.

Drop the step-2 bullet about not trusting claims about this repository's own constraints, or compress it to one sentence pointing at Anti-Patterns #2, which repeats it almost word-for-word.

Trim When to Use / When NOT to Use to only the non-obvious additions beyond the frontmatter description (e.g. keep the dated-plans example and the ADR-supersession rule, cut the one-line-lookup and subjective-preference restatements).

DimensionReasoningScore

Conciseness

The body is dense and free of Claude-known concept padding, but the same key points are stated multiple times: "A verdict without a cited source is a guess, not a finding" appears in both the intro and Mindset sections, step 2's bullet "AVOID trusting a claim about this repository's own constraints... without reading the actual source first" is restated nearly verbatim in Anti-Patterns #2, and When to Use / When NOT to Use largely restate the frontmatter description the reader already has. This is more than the minor trimmable instances of anchor 4 and fits anchor 3's "could be tightened".

3 / 5

Actionability

The guidance is fully concrete and executable: a copy-paste validator invocation with exit-code semantics ("scripts/validate-tech-evaluation.sh <path-to-yaml>" with exit 0 / exit 1 meanings), the exact verdict enum, the exact scaffold path, a verbatim subagent instruction list, and a concrete BAD/GOOD YAML rationale example. As an instruction-only skill, this meets the copy-paste-ready anchor 5.

5 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with an explicit validation checkpoint (step 3, with exit-code interpretation), a failure feedback loop ("send the YAML back to the subagent rather than manually patching it into shape"), and a completion confirmation ("confirm the new file is present in the regenerated index before reporting the evaluation as complete"). This matches the anchor-5 pattern of validate -> fix -> retry with checkpoints.

5 / 5

Progressive Disclosure

The body is a genuine overview: all five referenced bundle files (references/question-dimensions.md, references/finding-record-layout.md, assets/templates/tech-evaluation-scaffold.yaml, assets/schemas/tech-evaluation.schema.json, scripts/validate-tech-evaluation.sh) exist and are one level deep, clearly signaled both inline and in a dedicated References table with a When-to-Use column. Content is appropriately split with easy navigation.

5 / 5

Total

18

/

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 states concrete capabilities, gives both positive and negative use conditions, and lists natural trigger phrases verbatim. The explicit verdict enum and Do-NOT-use boundaries make triggering behavior highly predictable.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full pipeline: "Investigate a candidate library, dependency, or file format against a fixed question set", "end with exactly one cited recommendation (adopt / keep_current / reject / needs_more_research)", and "Validates the structured output against a JSON schema before writing a human-readable finding". Coverage is comprehensive with no gaps, matching the anchor-5 example rather than the minor-gaps anchor 4.

5 / 5

Completeness

It explicitly answers both what (investigate against a fixed question set, validate against a JSON schema, write a human-readable finding, one cited recommendation) and when ("Use when choosing between candidate npm packages, dependencies, or file formats for a specific integration point, or when a plan or ADR decision hinges on an unverified factual claim"), with concrete trigger phrases. It also adds explicit negative triggers ("Do NOT use for one-line version lookups..."), which strengthens rather than weakens completeness.

5 / 5

Trigger Term Quality

It provides an explicit trigger list of natural phrases users would actually say ("evaluate this library", "investigate this dependency", "compare X vs Y", "which format should we use", "is this package maintained") plus concrete Use-when conditions mentioning npm packages, dependencies, file formats, and ADRs. This is comprehensive coverage including synonyms, exceeding the few-terms-missing anchor 4.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (evidence-cited technology evaluation with schema-validated output) with distinct triggers and explicit exclusions ("Do NOT use for one-line version lookups, purely subjective preference calls... or a technology choice already settled by an existing ADR"). Minimal conflict risk with adjacent research/comparison skills.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 5 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/project-mgmt/tech-evaluation/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.