CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cache

Use when the user wants to view, search, add, edit, prune, archive, or clear hyperflow memory entries. CRUD interface for `.hyperflow/memory/` — never modifies source code, only memory files. Trigger with /hyperflow:cache, "show memory", "search memory for X", "clear memory", "what does hyperflow remember about Y".

Quality

78%

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/ai-agency/hyperflow/skills/cache/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 operational spec with genuinely concrete, executable guidance, strong worked examples, and validation checkpoints for destructive operations. Its weaknesses are token efficiency — four sections (Flow, Instructions, Overview, Output) substantially duplicate each other — and references to paths (a script and DOCTRINE.md) that are not present in the bundle.

Suggestions

Collapse the 'Flow', 'Instructions', 'Overview', and 'Output' sections into one canonical sequence/output spec; the current four sections restate the same subcommand list and 4-step flow with slightly different wording.

Trim the inlined 8-step compact flow to a short summary plus the output format, leaving the full protocol in references/compaction.md, which already documents it.

Fix dangling bundle references: either include scripts/memory-index.py and the DOCTRINE.md target in the bundle, or reword them as external/plugin-owned resources so the paths are not presented as resolvable skill files.

DimensionReasoningScore

Conciseness

The body is mostly efficient — no explanations of concepts Claude already knows — but it carries clear redundancy: 'Flow' and 'Instructions' state the same 4-step sequence nearly verbatim, 'Overview' repeats the subcommand list already given in the table, and 'Output' restates per-subcommand output details from 'Subcommand Details'. The ~10-line inlined compact protocol also duplicates content in references/compaction.md. It fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4, where only minor instances would need trimming — here four sections overlap materially.

3 / 5

Actionability

Concrete guidance throughout: an exact entry-write template, named target files, an executable command ('python3 scripts/memory-index.py .hyperflow'), specific confirmation prompts for destructive ops, and worked examples with real output formats. Not anchor 5 because some cited executables do not resolve in the bundle (scripts/memory-index.py is absent, as is ../hyperflow/DOCTRINE.md), and 'edit' leaves the entry-id slug format only implied by one example.

4 / 5

Workflow Clarity

Sequences are explicit and destructive/batch operations carry validation checkpoints: 'clear' requires AskUserQuestion confirmation and refuses headless ('Refuse and print clear requires interactive confirmation. Do not wipe.'), 'prune' checks file existence ('test -f'), and 'compact' includes a dedup review and checksum refresh across an 8-step flow. Anchor 4 rather than 5 because some subcommands (archive, migrate, edit) lack post-operation verification or feedback loops.

4 / 5

Progressive Disclosure

Good structure with well-signaled, one-level-deep references that all exist in the bundle (references/memory-system.md, compaction.md, output-style.md), each described in a Resources section. Scored against the actual bundle, two referenced paths do not resolve ('scripts/memory-index.py' and '../hyperflow/DOCTRINE.md') and the compact protocol is inlined despite its dedicated reference file — minor-to-moderate organization gaps that keep this below anchor 5 and make it sit between anchors 3 and 4, noticeably above the midpoint.

4 / 5

Total

15

/

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 that clearly states what the skill does, when to use it, and how it is triggered, with concrete action verbs and a helpful safety boundary. The main gaps are slightly incomplete action coverage (stats/migrate/compact/off missing from the verb list) and a few generic memory phrases that could collide with other memory-management skills.

DimensionReasoningScore

Specificity

Names the domain ('CRUD interface for `.hyperflow/memory/`') and a list of concrete actions ('view, search, add, edit, prune, archive, or clear hyperflow memory entries') plus an explicit boundary ('never modifies source code, only memory files'). It falls short of anchor 5 because the action list omits several subcommands the skill actually supports (stats, migrate, off, compact), leaving minor coverage gaps — squarely 'several specific actions; minor gaps'.

4 / 5

Completeness

Explicitly answers both what ('CRUD interface for `.hyperflow/memory/` — never modifies source code, only memory files' with an enumerated action list) and when ('Use when the user wants to view, search, add, edit, prune, archive, or clear hyperflow memory entries') with concrete trigger phrases. This matches the anchor-5 example structure exactly; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ('show memory', 'search memory for X', 'clear memory', 'what does hyperflow remember about Y') and the /hyperflow:cache invocation. Not anchor 5: common variations like 'remember this', 'forget X', or 'memory stats' are absent, so keyword coverage is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

The hyperflow-scoped path and '/hyperflow:cache' trigger give it a clear niche with distinct triggers, but generic phrases like 'clear memory' and 'show memory' could overlap with other memory/persistence skills. Mostly distinct with minor overlap risk — anchor 4, not 5.

4 / 5

Total

17

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

12

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/ai-agency/hyperflow/skills/cache/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.