CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

init-deep

Initializes a hierarchical AGENTS.md knowledge base for a project. Use when a repo needs its structure, commands, and conventions documented for agents.

Quality

70%

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 ./plugins/omo/skills/init-deep/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 core init-deep workflow is strong: highly actionable bash commands and spawn examples, a quantified scoring matrix, explicit decision thresholds, and a well-checkpointed four-phase process with a review pass. The main costs are the dense, repetitive harness-compatibility preamble bloating the token budget and the fully monolithic structure with zero reference files.

Suggestions

Move the Codex Harness Tool Compatibility section (the routing table and V1/V2 rules) into a reference file and keep a short routing summary inline, cutting significant tokens from the always-loaded body.

Deduplicate the repeated override clause — 'If a code block below conflicts with this section, this section wins' appears three times; state it once at the top of the section.

Add an explicit post-regeneration validation checkpoint for the destructive '--create-new' mode (e.g., verify every extracted insight from the old files appears in the regenerated set before reporting completion) to lift workflow clarity.

DimensionReasoningScore

Conciseness

The workflow itself is deliberately telegraphic ('Telegraphic or die', 'Over-documenting: Not every dir needs AGENTS.md'), but the ~23-line Codex compatibility preamble is dense and redundant — it repeats 'If a code block below conflicts with this section, this section wins' three times and re-explains V1/V2 spawn routing at length. This matches anchor 3 (mostly efficient, some unnecessary explanation or tightening possible) rather than anchor 4.

3 / 5

Actionability

Provides copy-paste-ready bash (find/awk/wc pipelines for scale measurement), concrete spawn calls with full prompts, a quantified scoring matrix with thresholds, explicit decision rules (>15 create, <8 skip), and a complete root AGENTS.md template. Minor gaps keep it below anchor 5: the 'for loc in AGENTS_LOCATIONS' generation loop and '${loc.path}' placeholders are templating rather than executable code.

4 / 5

Workflow Clarity

A clear 4-phase sequence (Discovery → Scoring → Generate → Review) with explicit checkpoints: per-phase TodoWrite tracking, a merge point after discovery, a file-writing safety rule ('NEVER use Write to overwrite an existing file'), and a Phase 4 review pass ('Remove generic advice / Trim to size limits / Verify telegraphic style') plus quality gates (50-150 lines). It stops short of anchor 5 because the destructive '--create-new' flow (read all → delete all → regenerate) has no post-regeneration verification that existing knowledge was preserved.

4 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), and everything (~330 lines) is inline in SKILL.md. Section headers are good, but content that could live in separate reference files — the Codex tool-compatibility preamble and the full AGENTS.md template — is inlined with no one-level-deep references. This matches anchor 3 (some structure, but content that should be separate is inline) rather than anchor 4.

3 / 5

Total

14

/

20

Passed

Description

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

The description cleanly answers both what the skill does and when to use it, with a specific named artifact (AGENTS.md) keeping conflict risk low. Its weaknesses are limited action coverage (only 'Initializes') and missing natural trigger variations users might say, which keep specificity and trigger quality at the mid tier.

Suggestions

List the concrete actions in the description, e.g. 'Generates a root AGENTS.md plus complexity-scored subdirectory AGENTS.md files covering structure, commands, and conventions' to lift specificity.

Add natural trigger variations users would actually say, such as 'onboarding', 'project documentation', or 'CLAUDE.md/AGENTS.md setup', to strengthen trigger_term_quality.

State when each mode applies (e.g. 'Use for initial setup or refreshing stale project docs') to make the 'when' clause more concrete and push completeness toward 5.

DimensionReasoningScore

Specificity

Names the concrete artifact ('hierarchical AGENTS.md knowledge base') and its content scope ('structure, commands, and conventions'), but lists only one action verb ('Initializes') with no mention of directory scoring, root + subdirectory generation, or update modes. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than anchor 4, which requires several specific actions.

3 / 5

Completeness

The 'what' is clear ('Initializes a hierarchical AGENTS.md knowledge base for a project') and an explicit 'Use when...' clause is present ('Use when a repo needs its structure, commands, and conventions documented for agents'). It falls short of anchor 5 because the 'when' names content areas rather than concrete trigger moments or phrases a user would voice.

4 / 5

Trigger Term Quality

'AGENTS.md', 'structure', 'commands', and 'conventions documented' are reasonably natural phrases a user might say, but common variations and synonyms are absent ('onboarding', 'project docs', 'CLAUDE.md', 'init'). This fits anchor 3 (some relevant keywords, missing common variations) more than anchor 4's good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The AGENTS.md/'documented for agents' framing carves a fairly distinct niche with file-level triggers, but it overlaps with generic /init-style CLAUDE.md/README generators. This matches anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than anchor 5's minimal conflict risk.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

code-yeongyu/lazycodex

Path

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