CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hindsight-cloud

Store team knowledge, project conventions, and learnings from tasks. Use to remember what works and recall context before new tasks. Connects to Hindsight Cloud. (user)

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/hindsight-cloud/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 is highly actionable with copy-paste-ready CLI commands and a well-organized structure, and it appropriately documents the proprietary server pipeline. Its weaknesses are redundancy between 'Best Practices' and earlier sections, and the absence of validation checkpoints in the setup and recall/retain workflows.

Suggestions

Consolidate 'Best Practices' with the 'When to Store/Recall' sections to remove duplicated guidance and save tokens.

Add a post-setup verification step (e.g., a test 'hindsight memory recall' call) and brief error-recovery guidance for failed commands.

Show a brief example of interpreting a recall response (or empty result) so the recall workflow has an explicit checkpoint.

DimensionReasoningScore

Conciseness

The proprietary 'How Hindsight Works' pipeline explanation earns its tokens, but 'Best Practices' largely restates earlier sections ('Pass rich context' duplicates the pipeline section; 'Recall first' duplicates 'When to Recall'; 'Attribute individual preferences' and 'Distinguish project vs personal' duplicate 'When to Store'), and 'Architecture decisions and their rationale' appears verbatim in two sections. Not 4 because the redundancy exceeds minor trimming; above 2 because there is no padding of concepts Claude already knows.

3 / 5

Actionability

Fully executable, copy-paste ready commands throughout: 'hindsight memory retain <bank-id> "..."' with four concrete content variants plus a transcript example, recall queries, reflect, and complete setup commands (curl install, heredoc config with chmod 600). Placeholders are explicitly explained ('Replace <bank-id> with the user's actual bank ID') and common cases are covered.

5 / 5

Workflow Clarity

The setup flow opens with an explicit check ('Before using memory commands, verify the Hindsight CLI is configured') and the recall-then-work-then-store sequence is coherent, but there is no post-setup verification that the CLI works (e.g., a test recall), no error-recovery guidance for failed commands, and no checkpoints in the recall/retain loop. Not 4 because the validation gaps exceed 'minor'; above 2 because steps are detailed and well-sequenced.

3 / 5

Progressive Disclosure

No bundle files exist and the ~145-line body is organized into clear, navigable sections (Setup Check, How Hindsight Works, Commands, When to Store/Recall, Best Practices). Not 5 because the under-50-line single-file exception does not apply and some inlined content (the store taxonomy, Best Practices) is redundant rather than appropriately placed; above 3 because structure and placement are otherwise good.

4 / 5

Total

15

/

20

Passed

Description

75%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 solid description that states concrete capabilities, natural trigger language, and an explicit use clause in third-person imperative voice. Its main weaknesses are a purpose-framed rather than situation-framed 'when' clause and missing common synonyms for memory-related requests.

Suggestions

Reframe the 'when' as concrete trigger situations, e.g. 'Use when the user asks to remember, save, or recall team knowledge, conventions, or lessons learned, or before starting a task in this codebase.'

Add natural synonyms such as 'lessons learned', 'takeaways', or 'project knowledge' to broaden trigger coverage.

Briefly name the recall/reflect capabilities (e.g., 'recalls and synthesizes past context') so the 'what' matches the full command surface.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ('Store team knowledge, project conventions, and learnings', 'remember what works', 'recall context') with specific content types, though the command surface (retain/recall/reflect) is only partially represented. Not 5 because coverage is not comprehensive; clearly above 3 since more than 1-2 actions are described.

4 / 5

Completeness

Has a clear 'what' (store team knowledge, project conventions, learnings) and an explicit 'Use to... before new tasks' clause covering 'when'. Not 5 because the 'when' is stated as purpose rather than concrete trigger situations (cf. 'Use when the user mentions...'); not 3 because the 'when' guidance is explicit, not merely implied.

4 / 5

Trigger Term Quality

Includes natural phrases users would say ('team knowledge', 'project conventions', 'learnings', 'remember what works', 'recall context'). Not 5 because common synonyms like 'lessons learned', 'takeaways', or 'save this for later' are missing; above 3 since keyword coverage is good and natural.

4 / 5

Distinctiveness Conflict Risk

'Connects to Hindsight Cloud' plus the shared-team-bank framing carves a distinct niche from generic memory skills. Not 5 because broadly shared trigger words like 'remember' overlap with other memory/knowledge skills; above 3 because the cloud service and team framing are distinguishing.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

vectorize-io/hindsight

Path

skills/hindsight-cloud/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.