skill-factory

Run a full build-and-ship pipeline from a spec — use for hands-off project generation

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/skill-factory/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and clearly sequenced with strong validation gates and error feedback, but it is a single monolithic file with some duplicated prohibited-action content and no progressive disclosure into bundle files.

Suggestions

De-duplicate the prohibited-actions list: keep it in the HARD-GATE under Step 5 and have the 'Prohibited Actions' section reference it rather than restating the items.

Tighten the banner template in Step 2 to the essential lines to reduce token overhead.

Consider moving the verbose Step 4.5 coverage-gate bash into a referenced script or bundled file so the SKILL.md overview stays lean.

Dimension	Reasoning	Score
Conciseness	The body is mostly operational and lean, but the prohibited-actions list is duplicated (HARD-GATE block and 'Prohibited Actions' section) and the banner template is verbose, so it 'could be tightened' rather than earning the fully lean level 3.	2 / 3
Actionability	It provides concrete, copy-paste-ready bash commands with exact script paths, flags, and file-lookup pipelines, matching the 'fully executable code/commands; copy-paste ready' anchor.	3 / 3
Workflow Clarity	An explicit 8-step sequence with labeled validation gates (Steps 3 and 6), 'DO NOT proceed' checkpoints, and a per-step error-handling section provides clear sequencing and feedback loops for recovery, matching the level 3 anchor.	3 / 3
Progressive Disclosure	No bundle files exist (references/scripts/assets absent) and all ~200 lines live inline in one file; the cross-references point to external plugin infrastructure rather than skill bundle files, so it is organized but monolithic rather than appropriately split across files.	2 / 3
	Total	10 / 12 Passed

Description

75%

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 third-person, concise, and answers both what and when with an explicit 'use for' trigger, though its trigger terms lean toward jargon and the action list is narrow rather than comprehensive.

Dimension	Reasoning	Score
Specificity	Names the domain ('build-and-ship pipeline from a spec') and an action ('hands-off project generation'), but does not list multiple concrete sub-actions, matching the 'names domain and some actions' anchor rather than the multi-action level 3.	2 / 3
Completeness	It states what the skill does ('Run a full build-and-ship pipeline from a spec') and includes an explicit trigger clause ('use for hands-off project generation'), answering both what and when; it is not capped at 2 because a 'use for' trigger clause is present.	3 / 3
Trigger Term Quality	Terms like 'spec', 'build-and-ship pipeline', and 'project generation' are relevant but somewhat jargon-heavy and miss common natural variations a user would actually say, fitting the 'some relevant keywords but missing common variations' anchor.	2 / 3
Distinctiveness Conflict Risk	The 'build-and-ship pipeline from a spec' framing carves a distinct niche that is unlikely to trigger for unrelated skills, matching the 'clear niche with distinct triggers' anchor; 'project generation' is the only mild overlap risk but the pipeline framing keeps it distinguishable.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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.

Repository: nyldn/claude-octopus
Path: .claude/skills/skill-factory/SKILL.md
Commit: 9f39f0c

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.