CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hierarchical-agent-memory

Scoped CLAUDE.md memory system that reduces context token spend. Creates directory-level context files, tracks savings via dashboard, and routes agents to the right sub-context.

Quality

72%

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/hierarchical-agent-memory/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured, concise overview with clear sequencing and a useful commands table. Its main weakness is actionability: the skill tells the agent what outcomes to produce ('go ham', auto-detect, generate files) without any executable mechanism — no scripts, install steps, or content templates — so Claude cannot fully execute setup from the body alone.

Suggestions

Add concrete execution details for setup: either reference bundled scripts/templates or show the exact CLAUDE.md content and file-creation steps the agent should perform.

Include a post-setup validation checkpoint (e.g., run 'ham audit' or verify the routing section resolves to real files) with a fix-and-retry loop.

Move the two example dialogues into a references/examples.md to keep SKILL.md a leaner overview with one-level-deep pointers.

DimensionReasoningScore

Conciseness

The body is efficient: no explanations of concepts Claude already knows, tight section structure, and a commands table instead of prose. Example 1's eight-file listing and the sample agent dialogues are mildly padded and could be trimmed, which keeps it below the lean 5 anchor but well above the verbose 2-3 anchors.

4 / 5

Actionability

Concrete elements exist (trigger commands like 'go ham', the .memory/ file structure, the routing markdown snippet, expected outputs), but the actual execution path is missing: no scripts are referenced, no install/setup commands, no templates for the CLAUDE.md contents the agent should write, and 'auto-detects your project platform' is unexplained. This matches the 3 anchor — concrete guidance that is incomplete with key details missing — rather than 4's mostly-executable guidance.

3 / 5

Workflow Clarity

Setup → Context Routing → Dashboard is clearly sequenced, with a commands table and maintenance checkpoints in Best Practices ('run ham audit every 2 weeks', 'review .memory/inbox.md periodically'). It falls short of 5 because there is no explicit post-setup validation (e.g., verify routing entries exist or files parse) and no error-recovery loop.

4 / 5

Progressive Disclosure

The body is well organized into clearly signaled sections (When to Use, How It Works, Commands, Examples, Best Practices, Limitations) with all content appropriately inline for a skill of this size and no nested or buried references. It does not reach 5 because there are no one-level-deep reference files at all (Examples or dashboard details could live in references/), and the ~120-line body slightly exceeds a lean overview.

4 / 5

Total

15

/

20

Passed

Description

66%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, specific description that clearly states what the skill does with concrete actions and good trigger keywords. Its main weakness is the absence of any explicit 'Use when...' guidance, which caps completeness and leaves triggering to inference.

Suggestions

Append an explicit trigger clause, e.g., 'Use when the user wants to reduce Claude Code token costs, set up per-directory CLAUDE.md files, or mentions HAM / context routing.'

Add one or two natural synonyms users would say ('memory', 'context files', 'token costs') to broaden trigger coverage.

Optionally mention setup and audit ('go ham', 'ham audit') so the description covers the skill's main commands.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Creates directory-level context files, tracks savings via dashboard, and routes agents to the right sub-context' — which names the domain plus three specific capabilities. It falls short of the 5 anchor because other capabilities from the body (setup/audit/insights) are omitted, leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clear and concrete (scoped CLAUDE.md memory system with three named functions), but there is no 'Use when...' clause or equivalent explicit trigger guidance — purpose is only weakly implied by 'reduces context token spend'. Per the judging guidelines, a missing explicit 'when' caps completeness at 3; it is above 2 because the 'what' is fully explicit.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'CLAUDE.md', 'context', 'token spend', 'dashboard', 'sub-context' are phrases users would plausibly say when needing this. A few natural variations are missing (e.g., 'memory', 'cost savings', 'reduce tokens'), keeping it below the comprehensive-synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The 'Scoped CLAUDE.md memory system' framing with dashboard-based savings tracking carves a fairly distinct niche with specific triggers. Minor overlap risk remains with generic agent-memory skills (the body itself lists 'agent-memory-systems' and 'agent-memory-mcp' as related), so it does not reach the clear-niche, minimal-conflict level of 5.

4 / 5

Total

15

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/hierarchical-agent-memory/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.