CtrlK
BlogDocsLog inGet started
Tessl Logo

setup-factory

Scaffold a new factory once. Asks for role models, thinking levels, a ticket id pattern, pull-request permission, and triage labels, then runs fstate init to write FACTORY.json and the empty SQLite store. Use for /setup-factory, "setup factory", "initialize factory", before the first ticket, or to update those choices. Do not use during plan, work, review, or wrap-up.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 dense, actionable setup skill: exact commands, an explicit flag matrix, conditional rules for every GitHub state, and clear checkpoints between exploration, questioning, and execution. The only weakness is the absence of failure-path guidance (what to do when init or a gh command errors), which keeps workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence throughout — terse imperatives like "Stop if this is not a Git repository", "Do not write FACTORY.json yourself", and "Leave an existing label unchanged" with zero padding or explanation of git/Node/gh basics. Every token is prescriptive; it matches the 'every token earns its place' anchor, and the level-4 'minor over-explanation' anchor does not apply.

5 / 5

Actionability

Fully executable guidance: the complete `init` invocation with every flag (`--plan-model <provider/id> --plan-thinking <level> ... --label <role>=<string>`), exact commands (`gh label create "<string>" --description "<meaning>"`, `pi --list-models`, `git rev-parse --show-toplevel`), and precise conditional rules for when to pass `--label`, `--github-repo`, `--github-cli`, and `--pull-requests`. Placeholders are parameters, not pseudocode, and the common cases are covered specifically enough to be copy-paste ready.

5 / 5

Workflow Clarity

The Explore → Ask → draft → init → post-init → Done sequence is clear with most checkpoints explicit ("Stop if this is not a Git repository", Node 24 check, "Do not call `init` until the user accepts the draft", "After `init` succeeds"). It is not a 5 because there are no error-recovery steps: nothing instructs what to do if `init` or `gh label create` fails mid-way, and the workflow ends with reporting rather than a final verification of the written state.

4 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references: [references/triage-labels.md](references/triage-labels.md) is a real bundle file used at the right moment, and [../create-factory-verification/SKILL.md] is a single clearly-linked sibling-skill handoff. Content is appropriately split — the label meanings table lives in the reference, not inline — and navigation is easy.

5 / 5

Total

19

/

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: concrete third-person actions, explicit use-when triggers with natural phrasings, and a negative scope clause that prevents overlap with related lifecycle skills. The only improvement would be broadening trigger synonyms (e.g. "create factory", "configure factory").

DimensionReasoningScore

Specificity

Multiple specific concrete actions in third person: "Asks for role models, thinking levels, a ticket id pattern, pull-request permission, and triage labels, then runs fstate init to write FACTORY.json and the empty SQLite store" — this comprehensively covers both the interaction and the artifacts written. It clearly fits the 'lists multiple specific concrete actions' anchor; the level-4 anchor's 'minor gaps in coverage' does not apply.

5 / 5

Completeness

Both halves are explicit: the 'what' ("Scaffold a new factory once... runs fstate init to write FACTORY.json and the empty SQLite store") and the 'when' ("Use for /setup-factory, 'setup factory', 'initialize factory', before the first ticket, or to update those choices"), plus a negative scope guard ("Do not use during plan, work, review, or wrap-up"). This matches the anchor for clearly and explicitly answering both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: the slash command "/setup-factory", quoted phrases "setup factory" and "initialize factory", plus situational triggers "before the first ticket" and "to update those choices". It falls short of the comprehensive anchor because common synonyms like "create factory", "configure factory", or "factory setup" are absent — a few natural terms are missing, which is the level-4 anchor exactly.

4 / 5

Distinctiveness Conflict Risk

A clear niche (one-time factory scaffolding) with distinct triggers, and the explicit exclusion "Do not use during plan, work, review, or wrap-up" sharply separates it from the sibling ticket-lifecycle skills that would otherwise be the main conflict risk. Minimal overlap risk remains.

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
geut/factory-skills
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.