CtrlK
BlogDocsLog inGet started
Tessl Logo

add-compact

Add /compact command for manual context compaction. Solves context rot in long sessions by forwarding the SDK's built-in /compact slash command. Main-group or trusted sender only.

64

Quality

81%

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.

The body is a strong, highly actionable workflow document: executable commands, exact expected outputs, explicit validation checkpoints, security constraints, non-goals, and troubleshooting. Its only weaknesses are mild redundancy around admin-denial behavior and a long inline verification matrix that would benefit from being split into a reference file.

DimensionReasoningScore

Conciseness

The body is dense with project-specific details (session contract, git merge, build/restart commands) and avoids explaining concepts Claude already knows. Minor redundancy keeps it below anchor 5: the admin-denial behavior ('Session commands require admin access.') is repeated across verification steps 4-5, steps 12-13, Security Constraints, and Troubleshooting, and could be consolidated.

4 / 5

Actionability

Fully executable throughout: exact shell commands ('test -f src/session-commands.ts', 'git fetch upstream skill/compact', 'npm test', 'launchctl kickstart -k gui/$(id -u)/com.nanoclaw'), exact messages to send, and exact expected outputs ('Compact boundary observed', 'Session commands require admin access.'). Matches anchor 5's copy-paste-ready standard with specific examples covering the common cases.

5 / 5

Workflow Clarity

Three clearly sequenced phases with an idempotency pre-flight check, explicit validation checkpoints (npm test, npm run build, integration test matrix, fresh-clone validation), and a Troubleshooting section with feedback loops naming exact error messages and recovery paths. The operation is explicitly non-destructive ('No destructive reset occurs'), so the destructive-operation cap does not apply; matches anchor 5.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear section headers and an accurate statement of what the merge adds. However, the 16-step integration test matrix (~40% of the body) is inline content that would sit better in a references/ file, and no bundle files exist to offload it — matching anchor 4's 'minor organization gaps' rather than anchor 5's appropriate content split.

4 / 5

Total

18

/

20

Passed

Description

65%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.

The description is concrete and distinct, with a clear 'what' and natural trigger terms like '/compact' and 'context rot'. Its main weakness is the missing explicit 'Use when...' trigger guidance, which caps completeness. Adding a usage-trigger clause would round it out.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user asks to compact, clear, or summarize the session context, or mentions context rot in long sessions.'

Include a few natural synonyms for trigger coverage, such as 'conversation history' or 'trim/summarize context', so users phrasing the need differently still match.

State the authorization behavior as an action (e.g., 'Authorizes main-group and device-owner senders only') to lift specificity toward comprehensive action coverage.

DimensionReasoningScore

Specificity

Names the domain ('/compact command', 'manual context compaction') and 1-2 concrete actions ('Add /compact command', 'forwarding the SDK's built-in /compact slash command'), matching the anchor for a clear but not comprehensive action list. It falls below anchor 4 because it does not list several specific actions (e.g., authorization enforcement or transcript archival are only hinted at), and above anchor 2 because the actions are concrete rather than generic.

3 / 5

Completeness

The 'what' is clear ('Add /compact command for manual context compaction... forwarding the SDK's built-in /compact slash command') but there is no explicit 'Use when...' clause; 'Solves context rot in long sessions' only weakly implies when. The rubric guideline caps completeness at 3 for missing explicit trigger guidance, so it cannot reach anchor 4 despite the clear what.

3 / 5

Trigger Term Quality

Includes natural keywords users would say: '/compact', 'context compaction', 'context rot', 'long sessions', 'slash command'. Good coverage matching anchor 4, but misses common variations like 'conversation history', 'summarize session', or 'trim context', keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

'/compact' is a highly distinct trigger with a clear niche (manual context compaction via the SDK's built-in command), and it explicitly distinguishes manual compaction from destructive resets or auto-compaction. Minimal conflict risk with closely related commands like /clear, matching anchor 5.

5 / 5

Total

15

/

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
jbaruch/nanoclaw-telegram
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.