CtrlK
BlogDocsLog inGet started
Tessl Logo

compact-chat-history

Summarize and compress the current conversation history into a structured context snapshot, then call compact_chat_history to save it. Read this skill only when the user explicitly asks to compact/summarize — system-triggered compaction injects the instructions directly without requiring a skill read.

64

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./backend/super-magic/agents/skills/compact-chat-history/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content delivers highly actionable, well-structured guidance for producing a compaction summary, but redundancy between the Instructions and Output Format Example hurts token efficiency, and explicit constraints lack verification checkpoints before the irreversible tool call.

Suggestions

Merge or trim the 'Output Format Example' so it does not duplicate the six-section Instructions, keeping only the structural skeleton that adds new information.

Add a validation checkpoint before calling compact_chat_history, e.g. verify all six sections are present and the summary meets the 10,000-character minimum.

Move the full output template into a references file (or collapse it inline) to improve progressive disclosure and reduce the monolithic body length.

DimensionReasoningScore

Conciseness

The body is mostly efficient but the 'Output Format Example' section largely restates the six sections already described in 'Instructions', introducing redundant tokens that could be tightened or merged.

2 / 3

Actionability

As an instruction-only skill it provides a precise, copy-paste-ready six-section template with per-section bullets and a concrete structural example, giving clear actionable guidance per the code_vs_instruction scoring note.

3 / 3

Workflow Clarity

The sequence is present ('Compress the current conversation into a structured summary, then call compact_chat_history immediately'), but explicit constraints (the 10,000-character minimum and all six sections) have no verification checkpoint before the tool call, leaving checkpoints implicit.

2 / 3

Progressive Disclosure

Sections are well-organized with headers, but the file exceeds 50 lines with no external references, and the large inline 'Output Format Example' duplicates instruction content that could be split out or trimmed.

2 / 3

Total

9

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and distinctive, clearly stating both the action and the explicit user-trigger condition with a guard against system-triggered invocation. Trigger-term coverage is the weakest aspect, limited to 'compact/summarize' without common variations.

Suggestions

Broaden trigger terms to include natural variations users might say, e.g. 'Use when the user asks to compact, summarize, compress, or shrink the conversation/chat history.'

Consider naming the output artifact more concretely (e.g. 'context snapshot saved to compact_chat_history') to reinforce distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Summarize and compress the current conversation history into a structured context snapshot, then call compact_chat_history to save it' — going beyond naming a domain to specify two distinct operations including the target tool.

3 / 3

Completeness

Explicitly answers both what (summarize/compress into a snapshot and save via the tool) and when ('Read this skill only when the user explicitly asks to compact/summarize'), with an explicit trigger clause so it is not capped at 2.

3 / 3

Trigger Term Quality

Triggers 'compact/summarize' are natural terms a user would say, but coverage is narrow with no common variations such as 'compress chat', 'save context', or 'shrink the conversation'.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (conversation-history compaction) with distinct triggers and an explicit guard against system-triggered compaction, making it unlikely to fire for the wrong skill.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
dtyq/magic
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.