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

79%

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 ./packages/omo-senpi/skills/init-deep/SKILL.md
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, operational skill body with excellent workflow engineering: explicit sizing formula, copy-paste node prompts, structural validation with a repair feedback loop, and templates that double as the distributed writers' instructions. The two residual weaknesses are the Phase 1 sizing spec not being executable code and an inlined-everything structure that, while justified by the load_skills design, makes the file long and slightly repetitive.

DimensionReasoningScore

Conciseness

The body is telegraphic and assumes Claude's competence throughout - no concept explanations, no library tutorials - with every section operational (formula, node prompts, templates, bash). Minor trimmable instances remain: the always-reduce rule is stated twice (the <critical> block and again in Anti-Patterns), and the committed-mode PR handoff prose runs long. Fits the efficient-with-minor-over-explanation anchor; not 5 given the ~330-line body and this repetition.

4 / 5

Actionability

Highly executable: copy-paste-ready scanner/writer prompt templates, an exact bash snapshot script, a scoring matrix with concrete thresholds and weights, and decision rules. The main gap is Phase 1's sizing "eval cell", which is formula/spec notation ("S = total source bytes after exclusions") labeled as "code, not mental arithmetic" but with no command that actually computes S or per_dir - a spec rather than runnable code, so it falls just short of fully copy-paste ready.

4 / 5

Workflow Clarity

Five phases are explicitly sequenced with a dedicated verify node emitting per-file PASS/FAIL verdicts and an amend-loop feedback cycle ("Loop until all PASS"), plus VERIFY/STOP-WHEN checklists embedded in every node prompt. The destructive --create-new path mandates reading all existing AGENTS.md files before deletion, so the batch/destructive validation cap does not apply. Matches the anchor for clear sequence, explicit validation, and error-recovery feedback loops.

5 / 5

Progressive Disclosure

A well-sectioned single file with clear phase headers, and the one external reference (mass-ulw's references/planning.md for wave doctrine and the failure playbook) is clearly signaled and one level deep. All templates and the scoring matrix are inlined - justified by design since writer nodes load only this skill - but a ~330-line body keeping the full bash script, PR handoff, and templates inline keeps it at good-structure-with-minor-gaps rather than a clean overview-plus-references split. No bundle files ship with the skill.

4 / 5

Total

17

/

20

Passed

Description

70%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 concise, well-formed description that explicitly answers both what and when with a clear artifact niche. Its main limitation is action coverage: it mentions only initialization, leaving the skill's update, regenerate (--create-new), and depth-limiting capabilities unstated, and it omits CLAUDE.md as a trigger term even though the skill handles it.

Suggestions

Broaden the action coverage beyond "Initializes" - e.g. "Creates or updates a hierarchical AGENTS.md knowledge base (root + complexity-scored subdirectories)" - so the description reflects the update and --create-new modes the skill supports.

Add "CLAUDE.md" and one or two natural variations (e.g. "project onboarding", "document the codebase") to the trigger clause, since users needing this skill may phrase the request in those terms.

DimensionReasoningScore

Specificity

Names one concrete action ("Initializes a hierarchical AGENTS.md knowledge base") plus the content areas ("structure, commands, and conventions"), but does not cover the skill's update-vs-regenerate modes or subdirectory scoring. Closest to the anchor for 1-2 concrete actions that are not comprehensive; score 4 would require several listed actions with only minor gaps.

3 / 5

Completeness

Both what ("Initializes a hierarchical AGENTS.md knowledge base for a project") and when ("Use when a repo needs its structure, commands, and conventions documented for agents") are explicit. The when-clause states a single condition rather than multiple concrete trigger phrases, so it fits anchor 4 (when could be more explicit or specific) rather than anchor 5.

4 / 5

Trigger Term Quality

Natural terms present: "repo", "structure", "commands", "conventions", "AGENTS.md", "documented for agents". A few natural terms are missing - notably "CLAUDE.md" (which the skill explicitly reads per Phase 1), "onboarding", or "project documentation" - matching the good-coverage-with-gaps anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

Clear niche tied to a specific artifact (hierarchical AGENTS.md knowledge base), which keeps it mostly distinct; minor overlap risk with generic project-init / CLAUDE.md documentation skills. Not anchor 5 because the documentation-for-agents territory is shared with those closely related skills.

4 / 5

Total

15

/

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.