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.

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 tightly engineered orchestration skill: concrete formulas, templated node prompts, a copy-paste snapshot script, and a genuine verify-repair feedback loop put it well above typical content quality. The deductions are the redundant Anti-Patterns section, the dag-construction step that depends entirely on an external skill's reference with no inline fallback, and the absence of any bundle split for long template/script material.

Suggestions

Trim the Anti-Patterns section to rules not already enforced inline (drop 'Redundancy', 'Ignoring existing', 'Over-documenting' duplicates of the template and Phase 1 rules) to push conciseness to the lean anchor.

Add a minimal inline dag-construction example (or a short fallback) so the central Phase 2/3 orchestration does not depend entirely on the mass-ulw skill's references/planning.md, which is not part of this bundle.

Move the root/subdirectory AGENTS.md templates and the Phase 5 snapshot bash script into a references/ file (one level deep, clearly signaled) so the main SKILL.md body reads as overview plus orchestration.

DimensionReasoningScore

Conciseness

The body is dense and telegraphic ('Verbose style: Telegraphic or die') with formulas, tables, and templated prompts instead of prose, and it assumes Claude's competence throughout. A few sections repeat rules already stated inline (e.g., 'Redundancy: Child never repeats parent' restates the template rule; 'Ignoring existing' restates Phase 1's --create-new handling), keeping it just below the 'every token earns its place' anchor.

4 / 5

Actionability

Most guidance is copy-paste executable: the Phase 1 sizing formula, fully templated scanner/writer node prompts, the exact bash snapshot block, and the weighted scoring matrix with thresholds. The main gap is that the dag construction itself ('Build and start the run in one eval JS cell with the dag SDK') delegates to the mass-ulw skill's references/planning.md with no inline example, leaving the central orchestration step under-specified within this file.

4 / 5

Workflow Clarity

Five phases are clearly sequenced with explicit validation checkpoints: each node prompt carries VERIFY and STOP WHEN clauses, the verify node emits per-file PASS/FAIL verdicts, and the repair loop ('Each FAIL line -> dag send the owning writer... Loop until all PASS') is a real feedback loop. The destructive --create-new path is guarded by the File Writing Rule (Edit vs Write, never overwrite) and read-existing-first ordering, so the batch/destructive cap does not apply.

5 / 5

Progressive Disclosure

The single file is well-sectioned with a clear phase-by-phase organization and no nested-reference chains, and inlining the scoring matrix and templates is functionally justified since writer nodes receive this file via load_skills. However, no bundle files exist at all and all content (templates, matrix, snapshot script) lives in one ~320-line body; a references/ split for the templates or snapshot script would ease navigation, so it sits between the 'good structure' and 'ideal split' anchors.

4 / 5

Total

17

/

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: third-person, concise, with an explicit 'Use when' clause naming concrete conditions and a distinct AGENTS.md knowledge-base niche. It stays just below the top anchors on trigger synonyms and on enumerating multiple action verbs.

DimensionReasoningScore

Specificity

It names the concrete deliverable ('a hierarchical AGENTS.md knowledge base') and enumerates the documented content ('structure, commands, and conventions'), which is more specific than the 1-2-action anchor but lists essentially one action verb (initializes) rather than several. This lands between anchors 3 and 4, noticeably above the midpoint.

4 / 5

Completeness

Both halves are explicit: the what ('Initializes a hierarchical AGENTS.md knowledge base for a project') and a concrete when-clause ('Use when a repo needs its structure, commands, and conventions documented for agents'). This matches the anchor where both are clearly and explicitly answered with concrete trigger phrasing; it is not the 4 anchor because the when-clause names specific conditions rather than being generic.

5 / 5

Trigger Term Quality

Natural terms a user would say are present ('AGENTS.md', 'repo', 'structure', 'commands', 'conventions', 'documented for agents'). A few common variations are missing, such as 'onboarding', 'project documentation', or 'CLAUDE.md', so it does not reach the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

'AGENTS.md knowledge base' carves a clear niche with distinct triggers, but the skill overlaps with generic repo-documentation/init skills (e.g., a CLAUDE.md-generating init), which is exactly the minor-overlap-with-closely-related-skills case at anchor 4.

4 / 5

Total

17

/

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

code-yeongyu/oh-my-openagent

Path

packages/omo-senpi/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.