CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prepare-repo

Prepare an existing repository so Tessl agents and Tessl Code Review work well in it: better agent context, verifiers, Code Review lenses, and lint rules drawn from how the team already works. Use when someone wants agents to make fewer mistakes in their repo, wants to prepare or improve their repo for agents, or wants to turn recurring review feedback into checks.

Quality

89%

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

The canonical home for this skill is tessl-labs/factory-setup

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exemplary orchestration skill: terse imperative steps, concrete commands and named tools, validation and feedback loops at every risky point, and clean one-level-deep routing into a complete, verified reference bundle. The only noticeable inefficiency is minor repetition of the confirmation gate rule and an awkward dual-numbering scheme between skill steps and timeline stages.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanations of concepts Claude already knows, but the change-nothing-until-confirmed rule is stated three times (session rules, decision point 2, step 5) and the step-number vs timeline-stage renumbering mapping in the message shape is convoluted. Not a 5 due to this minor redundancy; far above a 3 because nearly every token carries instruction.

4 / 5

Actionability

Fully concrete guidance: exact commands ("tessl code repo view <owner/repo> --json", "tessl install -g <plugin>", "tessl whoami"), named plugins and judge models ("tessl/tessl-verify", "openai/gpt-6-luna", "jev"), a complete example decision-point message, and precise per-section anchor links into each reference file. Though instruction-only, every step is executable as written.

5 / 5

Workflow Clarity

Eight clearly sequenced steps with a preflight that has explicit stop conditions, four named decision points, and validation checkpoints throughout: confirm each install is visible with a defined fallback ("needs <plugin>" items), backtest before commit, "check the configuration" before committing, and re-score only changed criteria. The apply/push operations are batch and repo-changing, yet validation and feedback loops are explicit, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The body is a routing overview that delegates each tier to one-level-deep reference files (scoring, evidence, routing, lint, verifiers, lenses, context, apply), and all referenced files and section anchors were verified to exist; scripts/ is reachable via the reference files that invoke it. Content is appropriately split, clearly signaled, and easy to navigate.

5 / 5

Total

19

/

20

Passed

Description

83%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 strong description in third-person voice that explicitly states both the concrete deliverables (agent context, verifiers, Code Review lenses, lint rules) and three natural "Use when" trigger clauses. Its only weaknesses are slightly incomplete synonym coverage for triggers and minor overlap with the sibling factory-setup skill's territory.

DimensionReasoningScore

Specificity

"better agent context, verifiers, Code Review lenses, and lint rules" lists several concrete deliverables in the repo-preparation domain. It is not a 5 because "so Tessl agents and Tessl Code Review work well in it" is soft and the scoring/backtest half of the workflow is unmentioned; it is well above a 3 because four specific outputs are named.

4 / 5

Completeness

Explicitly answers both: what ("Prepare an existing repository ... better agent context, verifiers, Code Review lenses, and lint rules") and when ("Use when someone wants agents to make fewer mistakes in their repo, wants to prepare or improve their repo for agents, or wants to turn recurring review feedback into checks"). This mirrors the 5-anchor pattern of concrete what plus explicit trigger phrases, and is third-person/infinitive voice with no padding.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "make fewer mistakes in their repo", "prepare or improve their repo for agents", "turn recurring review feedback into checks". Not a 5 because synonym coverage is incomplete (e.g., no "agent-ready", "AI-friendly repo", or tool-name variations); not a 3 because multiple natural trigger phrasings exist, not just domain jargon.

4 / 5

Distinctiveness Conflict Risk

The Tessl/Tessl Code Review framing carves a clear niche with distinct triggers. Not a 5 because "improve their repo for agents" overlaps the closely related sibling factory-setup skill and other agent-readiness skills; well above a 3 because the Tessl-specific tooling makes mistaken triggering unlikely.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

stephaniedominy/tessl-carnival

Path

.tessl/plugins/tessl-labs/factory-setup/skills/prepare-repo/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.