CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skillify

Capture a completed Codex workflow as a reusable SKILL.md package by analyzing session context plus optional session-collector evidence, interviewing the user with structured prompts, and writing a validated skill artifact. Use when the user asks to skillify or operationalize a repeatable process.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./Infrastructure/references/deferred-skill-context/skill-factory-skillify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The body is well-organized with a clear sequenced procedure, explicit constraints, and a fail-fast validation stance, but it under-delivers on specifics: the key skill-template reference is a broken stub, the interview prompts and structure checks referenced are never made concrete, and several sections redundantly restate the same cautions.

Suggestions

Replace the stubbed ./references/skill-template.md (which points to a non-existent fixtures/budget-archive path) with the actual template content, or link to a real file, so the 'Read when: template details are needed' reference resolves one level deep.

Make step 6 concrete by naming the exact structure checks to run (which validation gate, script, or checklist) instead of 'Run the relevant structure checks', and surface the bundled contract.yaml, evals.yaml, and task-profile.json with explicit links since step 5 depends on them.

Consolidate the overlapping Constraints / Anti-patterns / Gotchas / Failure mode sections and remove the duplicated reference lists (the top 'Read when' links repeat the bottom 'Reference materials' block) to tighten token use without losing guidance.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-style guidance with no concept explanations Claude already knows, but it could be tightened: the two 'Read when' links at the top duplicate the bottom 'Reference materials' block, and Constraints, Anti-patterns, Gotchas, and Failure mode restate overlapping ideas (e.g. 'stop and report missing inputs' appears in both Validation and Failure mode; no-transcript guidance appears in multiple sections). This fits the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than the level-4 anchor's 'minor instances of over-explanation'.

3 / 5

Actionability

The Procedure gives a real sequenced process with some concrete specifics (prefer ~/.agents/session-collector bundle evidence, draft using the template, include procedure/validation/constraints sections), but key details are missing for an instruction skill: the structured interview prompts named in the description never appear, step 6 says 'run the relevant structure checks' without naming any check or command, and the bundle's contract.yaml/evals.yaml/task-profile.json are only named parenthetically. This matches 'some concrete guidance but incomplete; missing key details' rather than 'mostly executable guidance with minor gaps'.

3 / 5

Workflow Clarity

The Procedure is a clear six-step sequence with an explicit validation checkpoint and feedback loop ('Run the relevant structure checks and iterate until clean'), plus a dedicated Validation section and fail-fast handling in Failure mode. Not the level-5 anchor because the validation checkpoints are somewhat abstract — 'relevant structure checks' and 'verify eval cases' are never tied to concrete checks — but this exceeds the level-3 anchor where checkpoints are missing or implicit.

4 / 5

Progressive Disclosure

The 'Read when:' pattern is a well-signaled one-level-deep reference style, but scoring against the actual bundle reveals real navigation failures: references/skill-template.md is a 2-line stub pointing to a fixtures/budget-archive/2026-04-19/... path that does not exist in the bundle, so the body's 'Read when: template details are needed' pointer resolves to nothing; and the bundled contract.yaml, evals.yaml, and task-profile.json are not clearly linked from the body at all. This fits 'some structure but could be better organized; references present but not clearly signaled' better than the level-4 anchor's 'references mostly clear'.

3 / 5

Total

13

/

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: it states concrete capabilities in third-person voice, gives an explicit 'Use when' trigger clause with natural phrasing, and occupies a clearly distinct niche. The only weakness is modest trigger synonym coverage around the core 'skillify' term.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "analyzing session context plus optional session-collector evidence", "interviewing the user with structured prompts", "writing a validated skill artifact" — and captures the workflow comprehensively in third-person voice. It matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level-4 anchor, which requires minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both what ("Capture a completed Codex workflow as a reusable SKILL.md package by analyzing... interviewing... and writing a validated skill artifact") and when ("Use when the user asks to skillify or operationalize a repeatable process") with concrete trigger phrases, exactly matching the level-5 anchor.

5 / 5

Trigger Term Quality

"skillify" and "operationalize a repeatable process" are phrases a user would naturally say, giving good keyword coverage, but common variations such as "turn this into a skill", "make a reusable skill", or "convert this workflow" are missing. It sits above the level-3 anchor (relevant keywords missing variations) but short of the level-5 anchor (comprehensive synonyms and extensions).

4 / 5

Distinctiveness Conflict Risk

The niche — converting completed workflow runs into SKILL.md packages with session-collector evidence — is clearly distinct, anchored by the unusual trigger term "skillify" and terms like "reusable SKILL.md package". Conflict risk with other skills is minimal; it does not fall to the level-4 anchor, which requires some overlap risk 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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Infrastructure/references/deferred-skill-context/skill-factory-skillify/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.