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, keeping pull requests moving, 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.

A strong, highly actionable procedural skill: exact commands, verbatim prompts, and validation feedback loops throughout a nine-step workflow. Its weaknesses are two overloaded run-on paragraphs that could be tightened, and two orphaned bundle files that break otherwise clean navigation.

Suggestions

Break the giant conditional paragraphs in step 2.8 and step 7.6 into bulleted if/then rules (or move the Code Review approval and doctor-message handling into a reference file) so each rule is scannable instead of embedded in a run-on block.

Link references/linear.md and references/triggers.md from SKILL.md (e.g., in step 3 where Linear connections and triggers are discussed), so every bundle file is reachable from the overview.

Resolve or guard the ../prepare-repo/SKILL.md link in step 9 — it does not exist in this bundle, so state the expected sibling-skill layout or make the offer conditional on the skill being installed.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of explanations of concepts Claude already knows, but step 2.8 and step 7.6 each pack a dozen-plus conditionals into single run-on paragraphs, and warnings repeat (e.g., "Do not retry or work around the refusal" appears in both step 8.1 and 8.2). Not 5: these sections could be tightened or tabulated without losing operational content; not 3: there is no genuinely unnecessary explanation — every rule is Tessl-specific edge-case handling.

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", "repository.attentionReason"), branch-name conventions, and verbatim questions to ask the user. Not 4: no gaps — common cases (fork, no tessl.json, uncommitted changes, missing app install) each have a specific prescribed response.

5 / 5

Workflow Clarity

Nine clearly sequenced steps with explicit validation checkpoints and feedback loops: re-run doctor after fixes, re-check the GitHub App after the user installs it, verify the remote tessl.json "reflects the whole submitted change" before going live, run the setup hook twice in a fresh clone, and "[confirm the Loops appear]" before declaring setup finished. Destructive actions (push, merge) are gated on explicit user consent, and refusals have prescribed fallbacks.

5 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references (starters, progress, testing, setup-hook, cli-version, links, customize, confirm-loops), all of which exist as real files. Not 5: references/linear.md and references/triggers.md exist in the bundle but are never linked from SKILL.md (linear is only hinted at via a command, not the file), and the ../prepare-repo/SKILL.md link does not resolve within this bundle — minor navigation gaps.

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.

An exemplary description: concrete capabilities, an explicit trigger clause with natural phrasing, and a clearly branded niche. Third-person voice throughout with no padding or over-claims.

DimensionReasoningScore

Specificity

"Set up, explain, or change a Tessl factory on a repository" plus five concrete automation examples ("triaging new tickets, shipping tickets as pull requests, keeping pull requests moving, reviewing code, or running a job on a schedule") gives multiple specific actions with comprehensive coverage. Not 4: no meaningful gaps in capability coverage; every clause names a concrete action.

5 / 5

Completeness

Explicitly answers both questions: the first sentence states what the skill does, and "Use when..." gives concrete trigger phrases for when to use it. Not 4: the "when" clause is fully explicit with multiple concrete triggers, not merely present.

5 / 5

Trigger Term Quality

"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" captures natural user phrasings well. Not 5: misses common synonyms such as "automations", "bots", or "automate my repository" that users would equally say.

4 / 5

Distinctiveness Conflict Risk

The Tessl-specific niche ("Tessl factory", "Tessl agents") with brand-anchored triggers makes confusion with any other skill very unlikely. Not 4: no realistic overlap scenario exists with closely related skills.

5 / 5

Total

19

/

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: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

fkukuck/fabro

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.