CtrlK
BlogDocsLog inGet started
Tessl Logo

aif-skill-generator

Generate professional Agent Skills for AI agents. Creates complete skill packages with SKILL.md, references, scripts, and templates. Use when creating new skills, generating custom slash commands, or building reusable AI capabilities. Validates against Agent Skills specification.

64

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/aif-skill-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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-structured multi-mode skill with excellent workflow sequencing and validation feedback loops. Its main weaknesses are redundancy — the Python-detection block and report templates are repeated inline rather than consolidated into the existing reference file, inflating the body past its own 500-line guideline — plus a dangling templates/ reference and undocumented substitution placeholders.

Suggestions

Consolidate the PYTHON_CMD detection/handling block (currently repeated nearly verbatim in Scan Mode, Validate Mode, and the Step 2 install flow) into one shared section and reference it from each mode.

Move the three inline report-output templates (BLOCKED/WARNINGS/CLEAN, FAIL/WARNINGS/PASS) into references/SECURITY-SCANNING.md, which already covers communication templates, to bring the body under its own 500-line limit.

Fix the dangling 'templates/' link (no templates directory exists in the bundle) and document the '{{skills_dir}}' and '{{skills_cli_agent_flag}}' substitution variables, which are used in commands but never explained.

DimensionReasoningScore

Conciseness

Mostly dense, purposeful instruction (exit-code semantics, anti-manipulation rules, YAML templates) rather than padded explanation, but the PYTHON_CMD detection/handling block is repeated nearly verbatim three times (Scan Mode, Validate Mode, Step 2 install flow) and three full report-output templates are inlined that duplicate material in references/SECURITY-SCANNING.md, pushing the body to ~545 lines. This is duplication that could be tightened rather than the pervasive padding of a score-2 document.

3 / 5

Actionability

Concrete, executable guidance throughout — exact scanner invocations ('python3 ~/{{skills_dir}}/aif-skill-generator/scripts/security-scan.py <skill-path>'), exit-code branches (0/1/2), a complete SKILL.md YAML template, and step-numbered workflows. Not a 5 because '{{skills_dir}}' and '{{skills_cli_agent_flag}}' substitution placeholders are never documented or expanded, and scripts/validate.sh and scripts/search-skills.py exist in the bundle but have no invocation guidance.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: exit-code-gated scan decisions, 'If BLOCKED at any level → run the cleanup helper', structure-check checklists with [FAIL]/[PASS] reporting, and enforcement re-checks against skill-context rules. This matches the anchor-5 pattern of validate → fix → retry with 'only proceed when validation passes' semantics.

5 / 5

Progressive Disclosure

Good structure: a mode-detection tree, references signaled at point of need ('see references/SECURITY-SCANNING.md', 'Follow the [Learn Mode Workflow](references/LEARN-MODE.md)'), and an 'Additional Resources' section listing files with descriptions; the referenced reference files all exist in the bundle. Minor gaps keep it below 5: the body links to 'templates/' which does not exist in the bundle, two scripts (search-skills.py, validate.sh) are never referenced, and the ~100-line inline security section overlaps content already in SECURITY-SCANNING.md while the body exceeds its own 500-line limit.

4 / 5

Total

16

/

20

Passed

Description

83%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 that clearly states what it does, names the package components it produces, and gives an explicit 'Use when' clause with natural trigger phrases. The only gaps are unmentioned supported modes (search, scan, Learn Mode) and slightly generic phrasing in one trigger clause.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Generate professional Agent Skills', 'Creates complete skill packages with SKILL.md, references, scripts, and templates', 'Validates against Agent Skills specification' — each with named artifacts. Not a 5 because capabilities the skill actually supports (searching existing skills, security scanning, Learn Mode from URLs) are absent, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both questions: what ('Creates complete skill packages with SKILL.md, references, scripts, and templates... Validates against Agent Skills specification') and when ('Use when creating new skills, generating custom slash commands, or building reusable AI capabilities') with concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

'Use when creating new skills, generating custom slash commands, or building reusable AI capabilities' supplies natural phrases a user would say. Not a 5 because common variants like 'skill generator', 'SKILL.md', or 'agent skills' as discovery keywords are missing.

4 / 5

Distinctiveness Conflict Risk

The 'Agent Skills' / 'skill packages' niche with 'slash command' triggers is mostly distinct from other skills. Not a 5 because 'building reusable AI capabilities' is broad enough to overlap with general automation or scaffolding skills.

4 / 5

Total

17

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (554 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

12

/

16

Passed

Repository
lee-to/ai-factory
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.