CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-setup

Set up, explain, or change a Tessl factory on a repository: agents that act on events in the repo, such as triaging new tickets, shipping tickets as pull requests, answering reviews and fixing checks on those pull requests, reviewing code, or running a job on a schedule. 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.

Quality

91%

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

88%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 actionable, well-sequenced setup workflow: every step names exact commands, fields, and consent gates, with verification loops throughout and heavy detail correctly pushed into references. The weak spots are a handful of overlong, repetitive passages (notably the doctor section) and slightly imperfect reference hygiene — one unreachable-from-SKILL.md file and mild second-level reference nesting.

Suggestions

Break the ~400-word single-paragraph item in step 7 ('Run tessl doctor --automations') into a short list of the distinct doctor findings and the plain-word response for each, and consolidate the repeated progress-timeline display rules into the single 'Rules for the whole session' bullet.

Link references/linear.md directly from SKILL.md (e.g. in the step 3 ticket-source checklist where the Linear integration is checked) so every bundle file is one hop from the body.

Consider promoting the most-linked targets of the second-level hops (triggers.md from starters.md, confirm-loops.md from testing.md) to direct links from SKILL.md where those steps are first mentioned, keeping navigation one level deep.

DimensionReasoningScore

Conciseness

The body is dense with product-specific rules Claude cannot know (CLI flags, JSON fields, permission gates) and wastes no tokens explaining known concepts, so it is well above 'mostly efficient' (3). However, a few spots ramble or repeat — e.g. step 7 item 8 is a single ~400-word paragraph on `tessl doctor` output, and the progress-timeline instruction is restated several times — which keeps it below 'every token earns its place' (5).

4 / 5

Actionability

Guidance is fully executable: exact commands with flags (`tessl project repair --json`, `gh repo view --json isFork,parent`), exact JSON fields to read (`linkedProject.workspaceName`, `credits.remaining`), a deterministic branch-naming scheme, and the literal questions to ask. It matches 'copy-paste ready commands; specific examples cover the common cases' and includes explicit error branches (integration failures, refused merges), exceeding the 'minor gaps' anchor at 4.

5 / 5

Workflow Clarity

Nine numbered steps are clearly sequenced with explicit validation checkpoints and feedback loops: consent gates before any state change, re-running the GitHub App checks until they pass, verifying the merged `tessl.json` from the remote before declaring live, and confirming Loops appear before handover. Error recovery is prescribed for each failure mode, matching the top anchor; the destructive/batch cap does not apply since verification is thorough.

5 / 5

Progressive Disclosure

The split is good — the 500-line body holds the orchestration flow while bulk detail (triggers 525 lines, testing 222 lines) lives in 12 clearly signaled reference files linked at point of need. It falls short of the 5 anchor ('one-level-deep references'): `references/linear.md` is never linked from SKILL.md (reachable only via starters.md), and reference-to-reference links (starters.md → triggers.md/linear.md/permissions.md, testing.md → confirm-loops.md) create shallow second-level hops.

4 / 5

Total

18

/

20

Passed

Description

92%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: third-person, concrete, and explicitly dual-purpose (set up / explain / change) with an explicit 'Use when' clause covering natural user phrasings. The only minor gap is a few missing synonyms such as 'automation', which keeps trigger term quality just below comprehensive.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'triaging new tickets, shipping tickets as pull requests, answering reviews and fixing checks on those pull requests, reviewing code, or running a job on a schedule' — giving comprehensive coverage of what the skill's automations do, matching the 'multiple specific concrete actions' anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

Both 'what' (the enumerated agent actions on repo events) and 'when' are answered explicitly, with the 'Use when' clause listing three concrete trigger conditions. It matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases' rather than the 4 anchor where the 'when' 'could be more explicit or specific'.

5 / 5

Trigger Term Quality

Natural user phrasings like 'wants Tessl agents to do work in their repo', 'asks what a factory is or what theirs does', and 'wants to add to, change, or customize it' are present and would be said verbatim, but a few common synonyms are absent (e.g. 'automation(s)', 'bot'). This fits 'good keyword coverage; a few natural terms missing' rather than the fully comprehensive anchor at 5, and clearly exceeds 'some relevant keywords but missing common variations' at 3.

4 / 5

Distinctiveness Conflict Risk

The 'Tessl factory' niche is product-specific and every trigger is scoped to Tessl ('Tessl agents', 'what a factory is'), so it would not fire for generic CI, review, or automation skills — a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (514 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository

stephaniedominy/tessl-carnival

Path

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