CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

initializer-agent

First-session agent for autonomous coding projects. Use when starting a new autonomous project, generating feature lists, setting up environments, or scaffolding project structure.

Quality

71%

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 ./.claude/skills/initializer-agent/SKILL.md

The canonical home for this skill is initializer-agent in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

57%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-sectioned, largely actionable, and free of tutorial padding, but has two systemic issues: a batch workflow with zero validation checkpoints, and a references/templates index that points at five nonexistent files. Converting the ASCII diagram to a compact numbered list with verification steps, and fixing or removing the broken file references, would lift it substantially.

Suggestions

Add validation checkpoints to the workflow (e.g., 'verify init.sh completes and the dev server starts', 'validate feature_list.json parses before committing') to satisfy the feedback-loop requirement for batch operations.

Fix the broken bundle references: create references/FEATURE-CATEGORIES.md and the templates/ files, or remove those sections — currently references/FEATURE-CATEGORIES.md and all three templates/*.template paths do not exist.

Replace the ~38-line ASCII workflow box with a compact numbered list and move the full artifact samples into the (currently missing) template files to reduce duplication.

DimensionReasoningScore

Conciseness

The body is mostly efficient — a quick-start snippet, artifact examples, and a category table with no tutorial prose explaining concepts Claude already knows. But it could be tightened: the ~38-line ASCII box diagram restates what a short numbered list would convey, and the full artifact samples (feature_list.json, init.sh, progress.txt) duplicate content the Templates section says lives in template files. This fits 'mostly efficient but includes some... could be tightened' better than the minor-trim level 4.

3 / 5

Actionability

Quick start gives runnable code ('from scripts.initializer import InitializerAgent', 'await agent.initialize_project(spec=..., tech_stack=[...])') matching the actual scripts/, artifact formats are shown as complete JSON/bash/markdown samples, and concrete commands appear ('git init', 'npm install', 'npx prisma migrate dev'). It falls short of fully copy-paste-ready level 5 because the ASCII workflow steps ('Parse requirements', 'Determine project structure') are high-level directions without commands, and the quick-start snippet leaves parameters like project_dir implicit.

4 / 5

Workflow Clarity

The 6-step workflow (read spec → generate features → create env script → scaffold → commit → save state) is clearly sequenced with per-step substeps. However, there are no validation checkpoints anywhere — no 'verify init.sh runs', no JSON validity check on feature_list.json, no server-startup confirmation — and this is a batch-operation workflow (100-200 features, multi-file scaffold, automated commit), which per the rubric caps workflow clarity at 3. Step 2's 'Add verification steps' applies to feature entries, not to the workflow's own checkpoints.

3 / 5

Progressive Disclosure

Structure is good on paper — dedicated References, Templates, and Scripts sections with clearly signaled paths, and the one reference that exists (references/INITIALIZER-WORKFLOW.md) is one level deep with no chaining. But scoring against the actual bundle: references/FEATURE-CATEGORIES.md does not exist, and the entire templates/ directory (all three .template files) is missing — 5 of the 9 referenced paths are broken. Missing referenced files undermine navigation and leave inlined content (the category table, artifact examples) with no home, which fits 'some structure but could be better organized' rather than the level-4 'minor organization gaps'.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid description with an explicit and well-phrased 'Use when...' clause covering multiple concrete trigger scenarios, in proper third-person voice. Its main weakness is that the 'what' half only labels the agent's role instead of summarizing its concrete outputs (feature list, init script, scaffold, initial commit).

Suggestions

State the concrete outputs in the 'what' clause, e.g. 'Generates feature lists, environment setup scripts, and project scaffolding, and makes the initial commit for autonomous coding projects.'

Add one or two natural synonyms users might say, such as 'bootstrap' or 'initialize a new project', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'generating feature lists, setting up environments, or scaffolding project structure' — going beyond naming the domain ('First-session agent for autonomous coding projects'). It is not a 5 because the actions all appear in the trigger clause while the 'what' statement itself is a role label rather than a capability list, leaving minor gaps in coverage.

4 / 5

Completeness

Both parts are present: what ('First-session agent for autonomous coding projects') and an explicit when ('Use when starting a new autonomous project, generating feature lists, setting up environments, or scaffolding project structure'). It sits between anchors 4 and 5: the 'when' is explicit and concrete, but the 'what' describes what the agent is rather than what it does, so it does not clearly match the 5 anchor.

4 / 5

Trigger Term Quality

'starting a new autonomous project', 'generating feature lists', 'setting up environments', and 'scaffolding project structure' are natural phrases a user would say. Not a 5 because common synonyms and variations such as 'bootstrap', 'initialize a project', or 'kick off' are missing; not a 3 because coverage clearly exceeds a single generic keyword set.

4 / 5

Distinctiveness Conflict Risk

'First-session agent for autonomous coding projects' carves out a clear niche tied to a specific workflow stage, with concrete triggers limiting misfires. Minor overlap risk remains with generic project-scaffolding or environment-setup skills, keeping it below the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/initializer-agent/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.