CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

understand-factory

Explain what a Tessl factory on this repository has done and is doing, and why something went wrong. Use when someone asks what their factory, automations, or loops have been doing, what happened on an issue or pull request Tessl worked on, why a run failed or nothing happened after they labeled an issue or left a review, whether anything is stuck or needs them, or how many credits it has used.

Quality

92%

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 highly actionable, well-sequenced investigation procedure: exact CLI commands and JSON field paths, ordered decision trees, and explicit re-check/escalation loops for stuck runs. The weaknesses are mild — a few convoluted passages that could be tightened and a monolithic single-file body that inlines some detail a references/ file could absorb.

Suggestions

Move the long 'Improve development' / features-page guidance in section 5 and the detailed trigger-matching recipes in section 4 into a references/ file, keeping a one-line signpost in the body, so SKILL.md stays a lean overview.

Tighten the densest passages (the pending-run paragraph in section 3, situation 7, and the 'Improve development' parenthetical in section 5) by splitting them into short bullets — the timing thresholds are valuable but currently buried in run-on sentences.

Consider trimming the duplicated guidance about reading a run's links and pull-request state, which appears in both step 2 and section 5, to a single forward reference.

DimensionReasoningScore

Conciseness

The body is dense and operational with almost no padding and no explanations of concepts Claude already knows — every section carries commands, JSON field paths, or decision rules. A few passages could be tightened (the convoluted 'Improve development' paragraph in section 5 and slightly repetitive guidance about run links repeated across steps 2 and 5), which keeps it at anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable guidance throughout: exact commands with flags (`tessl launch list --link-type github_issue --link-value <its URL> --limit 100 --json`), exact JSON paths (`data.attributes.links[]` with `rel` `produced`, `attributes.config.repoUrl`, `usage.credits.remaining`), a complete `gh api ... timeline --jq` pipeline, and concrete thresholds (90 seconds for run start, 30-second progress updates, 5- and 10-minute staleness bounds). The common cases are covered copy-paste ready.

5 / 5

Workflow Clarity

Sections 1–5 form a clear sequence, with ordered triage lists ("Check, in this order, and stop at the first that explains it"; "Take the first situation that applies") and explicit feedback loops: re-check a pending run after a minute, escalate to Tessl support after 10 minutes without progress, and re-examine whether a awaited event has since happened and matches a trigger. The skill is read-only, so no destructive-operation validation cap applies.

5 / 5

Progressive Disclosure

Good structure: numbered sections, clear cross-references to sibling skills with their purpose stated (the factory-setup skill, the features page), and no nested-reference chains. It stays at anchor 4 rather than 5 because the ~210-line single-file body inlines detail — the trigger-matching jq recipes in section 4 and the features-page guidance in section 5 — that could live in reference files, and the bundle contains no reference files of its own to split content into.

4 / 5

Total

18

/

20

Passed

Description

95%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: it states a concrete capability in third person and pairs it with an unusually thorough, natural-language 'Use when' clause covering the main user questions (activity, failures, silent no-ops, stuck runs, credits). The only soft spot is that the 'what' is one broad explain/diagnose action rather than an enumerated list of operations.

DimensionReasoningScore

Specificity

The description names the domain and concrete actions ("Explain what a Tessl factory on this repository has done and is doing, and why something went wrong") and elaborates capability through the when-clause (diagnosing failed runs, explaining why nothing ran, finding stuck items, reporting credits). It matches anchor 4 — several specific actions with minor gaps — rather than 5 because the core 'what' is a single explain/diagnose capability rather than multiple distinct operations.

4 / 5

Completeness

It explicitly answers both parts: the 'what' ("Explain what a Tessl factory on this repository has done and is doing, and why something went wrong") and a concrete 'Use when...' clause listing multiple trigger situations. This is the anchor-5 pattern; anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

The trigger clause enumerates the natural questions a user would actually ask — "what their factory, automations, or loops have been doing", "why a run failed or nothing happened after they labeled an issue or left a review", "whether anything is stuck or needs them", "how many credits it has used" — with synonyms (factory/automations/loops) covered. Not anchor 4, since no common variation of these user phrasings is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche — the Tessl factory on this repository — with distinct trigger terms ("Tessl", "factory", "loops", "runs", "credits") that no generic skill would fire on. Minimal conflict risk, matching anchor 5.

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

Warning

Total

15

/

16

Passed

Repository

stephaniedominy/tessl-carnival

Path

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