CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chat-history

Use when details may have been lost after context compaction, or when the Agent needs to inspect earlier compacted messages or previously created sub-agents.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 strong, dense tool-guide: every section delivers non-obvious operational facts with executable examples, a clearly sequenced list-search-read workflow, and explicit error-recovery guidance. The only real weaknesses are mild redundancy in the Rules section and inline reference-grade detail (e.g. the time_range grammar) that a slightly leaner file or a small reference file could absorb.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (it never explains ripgrep, Python, or what compaction is) and packs each section with non-obvious facts like "The range is `[start, end)` in the original file. Filtering never renumbers messages." Minor trimmable verbosity remains: the exhaustive "Never edit, overwrite, append to, truncate, rename, move, delete, or replace" enumeration and Rules bullets that repeat body points (e.g. preferring `history_files`).

4 / 5

Actionability

Four complete, copy-paste-ready `tool.call(...)` snippets with exact parameter dicts cover the common cases (default list, filtered list, scoped search, no-keyword browse, ranged read), and the exact `time_range` string forms are given with "Use the space-separated forms above in generated calls." This matches anchor 5: fully executable guidance covering common cases.

5 / 5

Workflow Clarity

The sequence is explicit up front ("The normal flow is list when the file is unknown, search for a message, then read a small range around a hit") and mirrored by the numbered sections, with feedback loops for error recovery: "If there is no result, shorten the pattern or remove it only after the history files, time range, and message types are narrow enough" and "If the Agent name or ID is unknown, list subagents before reading one." The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist; the single file is well-organized into numbered sections ("## 1. Discover history files" through "## Rules") with all content appropriately inlined for a skill of this size. It stops short of anchor 5 because at roughly 120 lines it exceeds the under-50-line simple-skill exception and reference-grade material (the full `time_range` grammar, pattern semantics) is inlined rather than split out.

4 / 5

Total

18

/

20

Passed

Description

73%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 focused, distinctive description with an explicit 'Use when...' trigger covering the post-compaction and sub-agent inspection scenarios. Its main weakness is that capabilities are only implied through the when-clause — it never states concretely what the skill does (list, search, read chat history) — and it omits the natural term "chat history" that mirrors the skill name.

Suggestions

State the concrete capabilities up front, e.g. "Lists, searches, and reads chat history files (current, compacted, and sub-agent histories). Use when details may have been lost after context compaction..." — this would raise specificity and completeness.

Add natural trigger synonyms such as "chat history", "conversation history", or "earlier messages" so users phrasing the need those ways still match the skill.

Keep the existing compaction and sub-agent triggers; they are the strongest and most distinctive part of the description.

DimensionReasoningScore

Specificity

The description names the domain (post-compaction history) and 1-2 concrete actions ("inspect earlier compacted messages or previously created sub-agents"), but does not comprehensively state capabilities such as listing, searching, or reading history. It matches anchor 3 rather than 4 because it does not list several distinct specific actions.

3 / 5

Completeness

It has an explicit when ("Use when details may have been lost after context compaction") and a what ("inspect earlier compacted messages or previously created sub-agents"), so both are present. It is not a 5 because the what is only embedded in the when-clause rather than stated as a concrete capability list.

4 / 5

Trigger Term Quality

Terms like "context compaction", "compacted messages", and "sub-agents" are natural phrases for this trigger scenario and give good keyword coverage. It falls short of anchor 5 because common variations such as "chat history" or "conversation history" (which match the skill's own name) are absent.

4 / 5

Distinctiveness Conflict Risk

"details may have been lost after context compaction" and "previously created sub-agents" carve out a clear niche with distinct triggers that few other skills would match. This matches anchor 5 (clear niche, minimal conflict risk) and not anchor 4, which would require some overlap with closely related skills.

5 / 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

dtyq/magic

Path

backend/super-magic/agents/skills/chat-history/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.