CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/factory-setup

Set up, explain, and change a Tessl factory on a repository: pick automations that fit how you work, such as triaging tickets, shipping tickets as pull requests, keeping pull requests moving, code review, and scheduled jobs.

78

Quality

98%

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

Overview
Quality
Evals
Security
Files

Quality

Content

96%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 exceptionally well-crafted guided-setup skill: lean, fully actionable, with a clearly sequenced workflow, per-step failure handling, consent checkpoints, and a doctor-based validation loop. The only weakness is that the key tessl.json entry reference (triggers.md) is nested two hops deep behind starters.md rather than linked directly.

Suggestions

Link references/triggers.md directly from SKILL.md (e.g. in step 7, where tessl.json entries are written) so the core entry reference is one level deep instead of reachable only via starters.md.

Consider a one-line 'Further reference' note in step 4 or the Plain-words section pointing to linear.md for the Linear ticket workflow, since SKILL.md currently gives no path to it.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout with no padding or explanation of concepts Claude already knows — the merge-commit heuristic ("Merge commits mean work arrives through pull requests") is task-specific inference guidance, not a git tutorial, and the Plain-words table maps Tessl jargon rather than explaining generic concepts. Every step carries a concrete instruction, matching anchor 5.

5 / 5

Actionability

Guidance is fully executable: concrete commands with expected JSON fields (`tessl project repair --json` → `linkedProject.workspaceName`, `tessl org list --json` → `credits.state`, `gh api repos/<owner>/<repo>/rules/branches/<default branch>`), an exact branch name (`setup-tessl-factory`), and exact questions to ask the user ("Do you want to go ahead?", "Is this what you want?"). This matches the copy-paste-ready anchor 5.

5 / 5

Workflow Clarity

The nine numbered steps are clearly sequenced with explicit validation checkpoints and error-recovery branches at each preflight item ("If it fails, ask the user to run `tessl login`"). Consent gates ("Stop if they say no", "Change nothing without asking") and the `tessl doctor --automations` fix-what-it-reports loop provide the feedback loops anchor 5 requires for a state-changing workflow.

5 / 5

Progressive Disclosure

Structure is good: the body stays at overview altitude, starters/customize/testing are well-signaled at their point of need, and detailed content (the 148-line triggers reference) is correctly externalized. However, the core payload `triggers.md` (and `linear.md`) is reachable only via a second hop through `starters.md`, while the rubric wants references one level deep from SKILL.md — a minor organization gap that fits anchor 4 rather than 5.

4 / 5

Total

19

/

20

Passed

Description

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

The description is a model example: it states concrete capabilities, includes an explicit 'Use when' clause with natural trigger phrases and synonyms, and occupies a distinct Tessl-branded niche. It closely matches the rubric's good_overall_examples pattern.

DimensionReasoningScore

Specificity

The description names the domain and lists multiple concrete actions: "Set up, explain, or change a Tessl factory" plus five concrete example jobs ("triaging new tickets, shipping tickets as pull requests, keeping pull requests moving, reviewing code, or running a job on a schedule"). Coverage is comprehensive for the domain with no minor gaps that would justify a 4.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the concrete action list, and the "when" is an explicit "Use when someone wants Tessl agents to do work in their repo, asks what a factory is or what theirs does, or wants to add to, change, or customize it" with concrete trigger phrases — matching anchor 5, not 4 where the "when" could be more explicit.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensively covered: "wants Tessl agents to do work in their repo, asks what a factory is or what theirs does, or wants to add to, change, or customize it" — including synonyms (add to / change / customize) and the concrete job terms users would say (triage, ship tickets, review). It clearly exceeds anchor 4, which allows missing natural terms.

5 / 5

Distinctiveness Conflict Risk

"Tessl factory" is a clear branded niche and every trigger condition mentions Tessl or factory, so the risk of firing for a generic PR-review or automation skill is minimal — a clear fit for anchor 5.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents