CtrlK
BlogDocsLog inGet started
Tessl Logo

deepinit

Deep codebase initialization with hierarchical AGENTS.md documentation

52

Quality

58%

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 ./skills/deepinit/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 body delivers a well-sequenced, largely actionable workflow with real non-obvious operational knowledge (parent-reference visibility, OMC loading model, merge/preservation rules). Its main weaknesses are token bloat from triplicate template/example content in the single file and the absence of any progressive-disclosure bundle structure.

Suggestions

Move the full AGENTS.md template and the two example outputs to references/template.md and references/examples.md, keeping SKILL.md to the workflow, rules, and a one-level-deep pointer to each.

Trim the 'Core Concept' section — the hierarchy diagram and loading-model sections already convey what AGENTS.md files are for without the bulleted explanation of purpose.

Turn the Step 5 validation table into an executable validation script (references or scripts/validate_hierarchy.sh) so the check-and-correct loop is a runnable command rather than manual find/grep inspection.

DimensionReasoningScore

Conciseness

Mostly efficient, domain-specific guidance (the parent-tag visibility rule and OMC loading model are genuinely non-obvious), but the body inlines the full template plus two complete example AGENTS.md files (~140 lines) that largely duplicate the template and each other, plus a 'Core Concept' section explaining what AGENTS.md files are for. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — not a 2, since most sections carry unique actionable content, and not a 4, since the triple-duplicated template/examples are significant trimmable bulk.

3 / 5

Actionability

A complete AGENTS.md template, a concrete Task invocation for directory mapping, merge rules for existing files, and validation commands (find/grep) give mostly executable guidance — matching 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because the Step 1 Task call is a sketch rather than a fully-specified invocation, and validation is offered as command hints rather than a complete check-and-fix script; not a 3 because the template and commands are directly usable, not pseudocode.

4 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with an explicit ordering rationale ('Generate parent levels before child levels to ensure parent references are valid') and a Step 5 validation table pairing checks with corrective actions, satisfying the batch/destructive-operation validation requirement. Not a 5 because there is no automated validate-and-retry feedback loop (validation is manual find/grep inspection), and not a 3 because explicit checkpoints with corrective actions are present.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headings, but this 340-line single-file skill inlines content that clearly belongs in separate bundle files — the full template (~45 lines) and the two full example outputs (~100 lines) would sit naturally in references/template.md and references/examples.md. This matches 'Some structure but could be better organized; content that should be separate is inline' rather than 2 (structure is not minimal) or 4 (no bundle files exist at all, so nothing is offloaded).

3 / 5

Total

14

/

20

Passed

Description

53%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 communicates a clear, specific deliverable in third person but omits any 'when to use' trigger guidance and under-utilizes the natural vocabulary users would employ to request this task. It sits at the midpoint of the rubric: correct but not self-activating.

Suggestions

Add an explicit trigger clause, e.g., 'Use when setting up a new codebase, generating or refreshing AGENTS.md project documentation, or when the user asks to initialize agent docs.'

Include natural synonyms users would actually say — 'project documentation', 'onboarding docs', 'generate AGENTS.md files' — to improve trigger term coverage.

Optionally name one or two more concrete actions (generate, compare/update existing files, validate the hierarchy) to raise specificity from one deliverable to a fuller capability list.

DimensionReasoningScore

Specificity

The description "Deep codebase initialization with hierarchical AGENTS.md documentation" names the domain (codebase initialization) and one concrete deliverable (hierarchical AGENTS.md documentation), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not enumerate several specific actions (e.g., generating, comparing, updating, validating AGENTS.md files), and not a 2 because it does name a concrete artifact rather than being purely generic.

3 / 5

Completeness

The 'what' is clear (creates hierarchical AGENTS.md documentation), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete rather than vague, and not a 4 because 'when' is entirely absent rather than just under-specified.

3 / 5

Trigger Term Quality

"codebase initialization" and "AGENTS.md" are relevant, real trigger terms, but common natural variations users would say are missing — "project documentation", "onboarding", "generate AGENTS.md files", "project setup". This matches the anchor 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'Good keyword coverage; a few natural terms missing', since most natural phrasings a user would utter are absent.

3 / 5

Distinctiveness Conflict Risk

The AGENTS.md-generation niche is fairly distinct with a clear signature artifact; overlap risk is limited to closely related skills (general init/documentation generators like an init or README skill). It is not a 5 because "deep codebase initialization" alone is broad enough that it could fire for other initialization tasks absent more distinct triggers.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
Yeachan-Heo/oh-my-claudecode
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.