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.

58

Quality

69%

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

63%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-engineered, highly actionable research procedure with clear phase sequencing and thoughtful conditional skip rules that respect token budgets at runtime. Its weaknesses are structural: duplicated Technology & Infrastructure requirements, persona/example padding, and large reference tables inlined in SKILL.md instead of split into a references/ bundle.

Suggestions

Move the manifest-to-ecosystem table, deployment/API/data-layer pattern tables, and the <examples> block into a references/ file (e.g., references/ecosystem-map.md), keeping SKILL.md as a lean overview with one-level-deep, clearly signaled links.

Delete the duplicate statement of Technology & Infrastructure section requirements (lines 170-178) — the Output Format template already specifies them — and fold the Core Responsibilities list into the scope table to remove the second enumeration of the same phases.

Drop the 'You are an expert repository research analyst...' persona paragraph and tighten abstract directives like 'Cross-reference discoveries across different sources' into concrete instructions (e.g., which sources to cross-check and how to report mismatches).

DimensionReasoningScore

Conciseness

The body is dense and mostly operational (skip rules, manifest tables) rather than explaining things Claude already knows, but there is real padding: the Technology & Infrastructure section requirements are stated twice (lines 170-178 and again in the Output Format template), Core Responsibilities duplicates the scope table's phase list, and the ~26-line <examples> block plus the 'You are an expert repository research analyst' persona intro add tokens without new instruction. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' — below anchor 4, well above anchor 2's padded profile.

3 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact globs ('a single glob of the repository root (`*`)', '`*/go.mod`'), a 16-row manifest-to-ecosystem table, explicit conditional skip rules, and a copy-ready output template. It falls short of anchor 5 only because some directives stay abstract ('Cross-reference discoveries across different sources', 'Prioritize official documentation over inferred patterns') and there is no worked example of a scoped invocation's output — matching 'mostly executable guidance; concrete code or commands with minor gaps' rather than the vague-guidance anchors 2-3.

4 / 5

Workflow Clarity

Sequencing is explicit and well-gated: Phase 0 'Run First', 0.1 → 0.1b → 0.2 → 0.3 with 'Using Phase 0 Findings' bridging into the numbered Research Methodology, plus a scoping table that says exactly which phases run per scope. Checkpoints exist ('Verify findings by checking multiple sources', 'distinguish between official guidelines and observed patterns') but are stated as QA principles rather than inline validation steps in the flow, so it matches anchor 4 ('most checkpoints present; minor validation gaps') and not anchor 5's explicit validate-fix-retry loops. No destructive/batch operations, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the SKILL.md is a single ~280-line document. Internal structure is good (headers, tables, clear sections), but reference-grade material — the manifest-to-ecosystem mapping, deployment/API/data-layer pattern tables, and the <examples> block — is inlined where a references/ file would keep the overview lean. This matches anchor 3 ('some structure but could be better organized; content that should be separate is inline') — better than anchor 2's structureless inline dump, short of anchor 4's well-split layout.

3 / 5

Total

14

/

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 third-person description that explicitly answers both what the skill does and when to use it, with a distinctive repo-research niche. It is held below top marks only by a single generic action verb ('conducts thorough research'), a slightly narrow trigger list, and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description enumerates concrete research targets — 'repository structure, documentation, conventions, and implementation patterns' — under a single action verb ('Conducts thorough research'). It lists several specific objects of research with only minor coverage gaps (e.g., issue/PR template analysis is not mentioned), fitting the 'several specific actions; minor gaps' anchor rather than the fully comprehensive anchor 5, and well above the 1-2-action anchor 3.

4 / 5

Completeness

Both parts are explicit: what — 'Conducts thorough research on repository structure, documentation, conventions, and implementation patterns'; when — 'Use when onboarding to a new codebase or understanding project conventions.' The 'when' clause is concrete but narrow (two triggers) and could name more situations, matching anchor 4 ('when could be more explicit or specific') rather than anchor 5's comprehensive concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural phrases are present: 'onboarding to a new codebase', 'understanding project conventions', 'repository structure', 'implementation patterns'. A few common variations users would actually say are missing (e.g., 'explore the codebase', 'read the code', 'project setup', 'get familiar with the repo'), matching 'good keyword coverage; a few natural terms missing' rather than the synonym- and extension-complete anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Repository structure, documentation, conventions, implementation patterns' carves a clear repo-research niche distinct from, say, PDF or commit-message skills, and the triggers ('onboarding', 'understanding conventions') are unlikely to fire for unrelated skills. Minor overlap risk remains with generic code-exploration/review-type skills, so it fits 'mostly distinct; minor overlap risk' rather than anchor 5's minimal-conflict profile.

4 / 5

Total

16

/

20

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.

Validation — 13 / 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.