CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

discovery

Use when starting a new product, feature, or initiative and you need structured discovery before planning - covers market analysis, technical feasibility, architecture, and go-to-market strategy.

Quality

78%

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

Quality

Content

75%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, instruction-only workflow skill: concrete steps, complete output templates with explicit enums, a clear phase sequence with an evidence gate, and good single-file organization. Its weaknesses are modest padding (the Anti-Rationalization table and description duplication), guidance gaps in the effort-estimation phase, and claimed market/GTM coverage that no phase delivers.

Suggestions

Trim the Anti-Rationalization table and the intro sentence duplicating the frontmatter description to improve token efficiency.

Provide a concrete token-estimation method in Phase 4 (e.g., how to derive estimates from task decomposition) and either add the claimed market analysis / go-to-market phases or remove those claims.

Add explicit gates between later phases (e.g., 'BLOCKED until risks are classified with mitigations'), mirroring the Phase 1 evidence gate, and clarify what the @builder/@data/@api/@tester agent references assume.

DimensionReasoningScore

Conciseness

The body avoids re-teaching concepts Claude already knows and mostly consists of lean step lists and output templates, matching anchor 4's 'efficient; minor instances of over-explanation'. The Anti-Rationalization table, the intro line duplicating the frontmatter description, and When-to-Use bullets restating the description's triggers are tokens that could be trimmed, preventing a 5.

4 / 5

Actionability

Every phase has numbered concrete steps and complete, copy-paste-ready output templates with enums (e.g., "GO | CONDITIONAL | NO-GO", "TRIVIAL | SIMPLE | MEDIUM | COMPLEX | EPIC") and an exact final output block. Minor gaps keep it below anchor 5: no method for the "Token estimate" step, no phase covering the market analysis/go-to-market strategy claimed in the description, and unexplained "@builder, @data" agent references.

4 / 5

Workflow Clarity

Phases 0-5 are clearly sequenced with one explicit validation gate ("**BLOCKED** until feasibility assessment is complete with evidence") and a Next Steps checklist, matching anchor 4's 'clear sequence with most checkpoints present'. Missing gates between later phases and any error-recovery/feedback loop prevent a 5; this is an analysis skill, not a destructive or batch operation, so the 3-cap does not apply.

4 / 5

Progressive Disclosure

No bundle files exist, and the single ~210-line SKILL.md is cleanly sectioned (When to Use, Workflow phases, Output, Rules) with templates integral to each phase rather than content that belongs in separate files. This matches anchor 4's 'good structure; most content is appropriately placed'; it exceeds the 50-line simple-skill threshold and inlines all output templates, so it does not meet anchor 5.

4 / 5

Total

16

/

20

Passed

Description

75%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 solid description with an explicit, concrete 'Use when' clause and several specific coverage areas. Its main weaknesses are the abstract core action claim ("structured discovery" with no mention of the actual deliverable) and claimed coverage of market analysis and go-to-market strategy that the skill body does not actually provide, which risks over-claiming.

Suggestions

State the concrete deliverable instead of the abstract 'structured discovery' — e.g., 'produces a discovery report with feasibility verdict, architecture assessment, risk register, and effort estimate'.

Add natural trigger phrases users would say, such as 'should we build', 'is this feasible', or 'explore/scope a new idea', to broaden trigger-term coverage.

Align claimed coverage with actual skill content: either add market analysis and go-to-market strategy phases to the body or drop those claims from the description.

DimensionReasoningScore

Specificity

"covers market analysis, technical feasibility, architecture, and go-to-market strategy" lists several specific coverage areas, exceeding anchor 3's 1-2 concrete actions, though the core action claim "structured discovery" is abstract rather than a concrete verb. Sits between anchors 3 and 4, matching 4's 'several specific actions; minor gaps' better than 3's minimal coverage.

4 / 5

Completeness

The 'when' is fully explicit with concrete triggers ("Use when starting a new product, feature, or initiative"), exceeding anchor 4's 'when could be more explicit'. However, the 'what' — "structured discovery" plus four coverage areas — never states the concrete deliverable (e.g., a go/no-go verdict report with estimates), keeping it between anchors 4 and 5.

4 / 5

Trigger Term Quality

Phrases like "starting a new product, feature, or initiative", "before planning", and "discovery" are natural terms users would say. A few common variations are missing (e.g., "should we build", "is this feasible", "scope a new idea"), which matches anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"structured discovery before planning" carves a clear niche distinct from planning skills, matching anchor 4's 'mostly distinct; minor overlap risk'. Broad triggers like "feature, or initiative" create some overlap risk with general planning/roadmap skills, preventing anchor 5's 'minimal conflict risk'.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

skills/discovery/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.