CtrlK
BlogDocsLog inGet started
Tessl Logo

repo-research-analyst

Conducts thorough research on repository structure, documentation, conventions, and implementation patterns. Use when onboarding to a new codebase or understanding project conventions.

63

Quality

76%

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 ./.agents/skills/repo-research-analyst/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and clearly sequenced with strong decision rules and a QA checkpoint, but it is a long monolithic file with some generic padding and no progressive disclosure into separate reference files.

Suggestions

Trim generic exhortations ('Your mission is...', 'Be systematic, thorough...') to tighten token efficiency.

Move the large manifest-to-ecosystem and infrastructure mapping tables into a one-level-deep reference file (e.g. references/manifest-mapping.md) signaled from SKILL.md to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is mostly concrete and useful (phase tables, skip rules, output template) but runs ~280 lines and includes generic motivational padding such as 'Your mission is to conduct thorough, systematic research...' and 'Be systematic, thorough, and always provide evidence for your findings', placing it at the 'mostly efficient but could be tightened' level rather than the lean level 3.

2 / 3

Actionability

As an instruction-only research skill it provides highly actionable, specific guidance — concrete glob patterns, a manifest-to-ecosystem mapping table, explicit skip rules keyed to prior findings, and a copy-ready output template — satisfying the level-3 'concrete, specific guidance' bar for instruction skills.

3 / 3

Workflow Clarity

The process is clearly sequenced (Phase 0 run first, then scoped phases) with explicit decision checkpoints (skip rules), a numbered methodology, and a QA verification step ('Verify findings by checking multiple sources'), matching the clear-sequence-with-validation anchor.

3 / 3

Progressive Disclosure

No bundle files exist and the entire skill is a single ~280-line monolithic file with no external references; while it is well-organized into sections, large reference material (mapping tables, the output template) is inline rather than split into one-level-deep referenced files, matching the 'some structure, content that should be separate is inline' anchor.

2 / 3

Total

10

/

12

Passed

Description

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is well-formed with an explicit Use-when trigger and a clear, distinctive niche, but its action language is generic ('conducts thorough research') and its trigger-term coverage omits common phrasings users would naturally use.

Suggestions

Replace the single generic verb with multiple concrete actions, e.g. 'Maps repository structure, reviews documentation, identifies conventions, and searches implementation patterns'.

Broaden trigger terms to include natural variations like 'understand the codebase', 'project patterns', or 'codebase conventions' that users actually say.

DimensionReasoningScore

Specificity

The description names several concrete research domains ('repository structure, documentation, conventions, and implementation patterns') but applies a single generic action verb ('Conducts thorough research') rather than listing multiple distinct concrete actions, matching the 'names domain and some actions, but not comprehensive' anchor rather than the multi-action level 3.

2 / 3

Completeness

It clearly answers both 'what' (research on repository structure, documentation, conventions, implementation patterns) and 'when' with an explicit 'Use when...' trigger clause, matching the level-3 anchor.

3 / 3

Trigger Term Quality

It includes natural triggers ('onboarding to a new codebase', 'understanding project conventions') a user might say, but coverage is limited and misses common variations such as 'understand the codebase', 'project patterns', or 'codebase conventions' that appear in the skill's own examples.

2 / 3

Distinctiveness Conflict Risk

The repository-research / onboarding niche with its distinct trigger ('onboarding to a new codebase') is clearly bounded and unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

10

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.