CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research

Research phase of RPI methodology. Spawns parallel subagents for codebase exploration AND web/pattern research, then synthesizes findings for user review. Produces compact research artifact. Use at the start of non-trivial features.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./tiles/crafter/skills/research/SKILL.md
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-structured orchestration skill with a clearly sequenced workflow, explicit validation loops, and exemplary progressive disclosure into two real reference files. The main weakness is redundancy at the end, where the same termination and handoff instructions are repeated across three sections.

Suggestions

Delete the '## After Research' section — it restates Workflow steps 4-6 (artifact written, user reviews, /clear, /draft) almost verbatim, adding ~10 lines of pure duplication.

Merge '## STOP — Phase Complete' into Step 6, whose closing 'Then STOP. Do not take any further actions' already conveys the same boundary; keep the do/don't bullets as a short list under Step 6.

Trim '## Context Compaction' to 2-3 lines or fold it into '## Purpose' — its before/after framing repeats the purpose bullets and the /clear rationale already given in Step 6's 'Why /clear?' note.

DimensionReasoningScore

Conciseness

The core workflow, depth tables, and anti-patterns are efficient and earn their tokens, but the ending is stated three times — Step 6's 'Then STOP. Do not take any further actions', the entire '## STOP — Phase Complete' section, and the '## After Research' section all restate the same termination and /clear → /draft handoff. The 'Context Compaction' section also partially re-explains the Purpose rationale; tightening these would lift it to 4-5.

3 / 5

Actionability

Highly actionable throughout: a concrete dispatch example ('Add discount codes to orders'), exact artifact path pattern ('docs/plans/YYYY-MM-DD-{topic}-research.md'), explicit tool usage ('TaskOutput block: false/true'), a verbatim copy-paste Step 6 output block, and links to real reference files. Not a 5 because the Task dispatch snippet ('Task(Explore): "..."') is illustrative pseudo-syntax rather than literal tool invocations, and agent counts are given as ranges.

4 / 5

Workflow Clarity

Six clearly numbered, sequenced steps with explicit validation checkpoints: a REQUIRED user-review step with an edit→re-ask feedback loop ('Repeat until the user approves'), thin-results handling guidance in Step 3, an explicit stop condition, and an anti-patterns checklist. This matches the anchor-5 pattern of clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

The body is a workflow overview that appropriately delegates detail to two real, one-level-deep, clearly signaled references — [agent prompts](references/agent-prompts.md) for full Task prompt templates and [research artifact template](references/template.md) for the output format. Both files exist, are linked with descriptive context, and no content that belongs in a separate file is inlined.

5 / 5

Total

17

/

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 that clearly states what the skill does and when to use it, with concrete verbs and mostly natural trigger terms. Its main weaknesses are unexplained methodology jargon ('RPI') and a 'when' clause that could name more concrete trigger phrases.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Spawns parallel subagents for codebase exploration AND web/pattern research', 'synthesizes findings for user review', 'Produces compact research artifact' — with only minor gaps in coverage. Not a 5 because 'Research phase of RPI methodology' leads with undefined jargon and the action list, while good, is not fully comprehensive.

4 / 5

Completeness

Both questions are answered: the 'what' is concrete (spawns subagents, explores codebase and web, synthesizes, produces artifact) and the 'when' is explicit ('Use at the start of non-trivial features'). Not a 5 because the 'when' is a single general clause rather than concrete trigger phrases like 'when the user mentions X' — matching anchor 4 ('when' could be more specific).

4 / 5

Trigger Term Quality

Contains good natural keywords ('Research', 'codebase exploration', 'web/pattern research', 'non-trivial features') that users would plausibly say. A few natural terms are missing (e.g., 'investigate', 'look into', 'explore'), keeping it below the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to 'Research phase of RPI methodology' with parallel-subagent orchestration, making it mostly distinct from generic skills. Minor overlap risk remains with plain 'research this topic' requests, which the body itself acknowledges ('Pure research tasks (use Explore agent instead)').

4 / 5

Total

16

/

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

ericjohnolson/tessl-test

Path

tiles/crafter/skills/research/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.