CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

init

Use when the user asks to set a project up for flowai for the first time — writes AGENTS.md and the documentation skeleton for a new or an existing codebase. Not for reconciling an existing AGENTS.md with newer templates.

67

Quality

84%

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

81%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 dense, highly executable workflow: exact commands, a verbatim interview prompt, explicit per-file confirmation gates, and a closing verification checklist with a re-run feedback loop. The weaknesses are stylistic: rule 8 in particular repeats its point at several times the length needed, and small template structures are duplicated inline rather than left in the template files.

Suggestions

Compress rule 8 to its operative core (a unified diff shown per file, one yes/no per file, asking ends the turn) — the current ~250-word paragraph restates the same rule in four or five ways, which is the largest single source of unnecessary tokens.

Drop the inline restatement of the SRS/SDS field structures in step 9 and keep only the deviation that matters (that '**Rationale:**' is mandatory); the field lists are already in the template files being read in the same step.

Tighten step 10's recording paragraph to the two bullet rules (one line per command under '### Detected Commands', one line per script under '### Command Scripts') without the meta-commentary about what an empty section means.

DimensionReasoningScore

Conciseness

The body is procedural and free of explanations of concepts Claude already knows, but several passages restate the same instruction many times: rule 8 spends ~250 words hammering per-file confirmation ('a prose summary, a change list, an excerpt, or a grouped description... is not a diff... Asking ends the turn... A question and the write it asks about cannot share a turn'), and step 6's brownfield note ('those are different documents, and a reader of AGENTS.md never sees them') and step 10's recording paragraph are similarly padded. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' — above level 2 because the padding is confined to a few passages rather than pervasive.

3 / 5

Actionability

Fully executable guidance throughout: verbatim bash commands ('deno run --allow-read <skill-dir>/scripts/generate_agents.ts .'), a complete copy-paste interview prompt with the exact JSON return schema, exact merge rules per legacy file, exact template paths and section names ('### Detected Commands', '### Command Scripts'), and concrete JSON fields to check ('opencode_json.has_subdirectory_globs'). Matches the level-5 anchor: copy-paste ready commands with specific examples covering the common cases.

5 / 5

Workflow Clarity

Twelve clearly sequenced steps with explicit Greenfield/Brownfield conditions, an agent-judgment decision point, per-file diff confirmation gating every destructive write, and a final verification checklist with a re-run feedback loop ('If passed is false (exit code 1), fix the issues before proceeding'). This matches the level-5 anchor (explicit validation steps, feedback loops for error recovery, checklists); despite involving overwrites and deletions, the per-file confirmation and re-verification satisfy the destructive-operation cap.

5 / 5

Progressive Disclosure

The 38KB AGENTS.template.md is appropriately externalized to assets/, references are clearly signaled at point of use and are one level deep, and every referenced path (assets/AGENTS.template.md, assets/SRS.template.md, assets/SDS.template.md, scripts/generate_agents.ts) exists and matches what the body claims about it. Short of level 5 because some template detail is duplicated inline — step 9 restates the full SRS/SDS field structure ('## 3. Functional Reqs' with the five per-FR fields, '## 3. Components' with Purpose/Interfaces/Deps) that already lives in the tiny template files — and rule 8's long prose is main-body content that could live in a reference.

4 / 5

Total

17

/

20

Passed

Description

82%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 with an explicit 'Use when' trigger, a concrete 'what', a first-time scope condition, and a useful negative boundary. Its main weakness is thin action coverage — most of the skill's actual outputs are not named. Voice is third person throughout.

Suggestions

Name one or two more concrete outputs in the 'what' half (e.g., the CLAUDE.md symlink or the greenfield interview) to lift specificity beyond 1-2 actions.

Add common trigger synonyms such as 'initialize' or 'bootstrap' alongside 'set a project up' so users who phrase the request differently still hit the skill.

DimensionReasoningScore

Specificity

The description names concrete artifacts — 'writes AGENTS.md and the documentation skeleton for a new or an existing codebase' — but stops at 1-2 actions; it omits other core capabilities (CLAUDE.md symlink, the greenfield interview, legacy-layout collapse, dev-command setup). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive', and is below level 4 ('several specific actions; minor gaps') because most of the skill's actions are unlisted, while above level 2 because what it does state is concrete, not generic.

3 / 5

Completeness

It explicitly answers both questions: 'Use when the user asks to set a project up for flowai for the first time' (when, with a concrete trigger phrase) and 'writes AGENTS.md and the documentation skeleton' (what), plus a negative boundary ('Not for reconciling an existing AGENTS.md with newer templates'). This matches the level-5 anchor (both what and when with concrete trigger phrases); level 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

'Use when the user asks to set a project up for flowai for the first time' is a natural multi-word trigger, reinforced by 'for a new or an existing codebase' covering both scope cases. It sits between anchors: better than 3 ('some relevant keywords but missing common variations') because the main trigger phrase is genuinely what a user would say, but short of 5 because common synonyms such as 'initialize', 'bootstrap', 'scaffold', or 'onboard' are absent.

4 / 5

Distinctiveness Conflict Risk

'flowai' is a niche proper noun, the first-time condition narrows the trigger, and the explicit exclusion ('Not for reconciling an existing AGENTS.md with newer templates') separates it from an adjacent maintenance skill. Clear niche with distinct triggers and minimal conflict risk — the level-5 anchor.

5 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

15

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai/skills/init/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.