CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-agentmemory-skill

The house format and rules for writing or updating an agentmemory skill. Use when adding a new skill, restructuring an existing one, or reviewing a skill contribution for consistency.

Quality

86%

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

86%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 lean, rule-dense instruction skill that practices what it preaches on token efficiency and structure, with concrete commands and validation via CI. Its gaps are the absence of a worked example and a numbered workflow for its own primary task, both of which it requires of the skills it governs.

Suggestions

Add a short worked example (e.g., a 3-4 line model SKILL.md frontmatter and body skeleton) to raise actionability to fully copy-paste ready guidance.

Include a brief numbered workflow with decision gates for the main task (draft -> move dense facts to REFERENCE.md -> run skills:gen -> check) so the primary process is sequenced like the generated-facts flow already is.

DimensionReasoningScore

Conciseness

Every line is a rule, a limit, or a command ('Frontmatter: name, description...', 'Stay under 100 lines', 'npm run skills:gen'), with zero concept explanations or padding. This matches the lean-and-efficient anchor; level 4 would require at least minor over-explanation to trim, which is absent.

5 / 5

Actionability

Guidance is mostly executable: concrete frontmatter fields, a required body order, hard limits, and runnable commands ('Edit the source, then run npm run skills:gen'). It stops short of level 5 because it never shows a worked example of a well-formed SKILL.md even though it mandates 'Quick start (one concrete example)' for the skills it governs.

4 / 5

Workflow Clarity

The generated-facts flow is clearly sequenced with a validation backstop ('Edit the source, then run npm run skills:gen. CI runs npm run skills:check and fails on drift') and a closing Checklist acts as verification. It misses level 5 because the primary writing/updating task itself has no numbered workflow or decision gates of the kind the skill prescribes for others.

4 / 5

Progressive Disclosure

The body is under 50 lines, well-organized into clear sections, and needs no external references; mentioned files (REFERENCE.md, EXAMPLES.md, TROUBLESHOOTING.md) are one level deep and clearly signaled. Per the simple-skill scoring note, this merits a 5 on organization alone.

5 / 5

Total

18

/

20

Passed

Description

82%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 with an explicit 'Use when' clause carrying three concrete, natural triggers and a clearly stated capability. The only soft spot is capability specificity, which states the domain and two actions without listing the concrete facets of the format it governs.

DimensionReasoningScore

Specificity

The description names the domain ('agentmemory skill') and the actions 'writing or updating' but does not enumerate what the format/rules cover (frontmatter, body order, line limits). This matches the anchor for naming a domain with 1-2 concrete actions, not the level above, which requires several specific actions.

3 / 5

Completeness

It explicitly answers both parts: the 'what' ('The house format and rules for writing or updating an agentmemory skill') and a concrete 'Use when' clause listing three trigger phrases. This matches the anchor requiring both what and when with concrete triggers; level 4's example has a noticeably weaker 'when'.

5 / 5

Trigger Term Quality

'Use when adding a new skill, restructuring an existing one, or reviewing a skill contribution for consistency' provides natural phrases users would say in this workflow. It misses common variations like 'updating', 'editing', or 'SKILL.md', so it falls short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche (house format for agentmemory skills) with distinct triggers (adding, restructuring, reviewing a skill contribution), minimizing overlap with other skills. Level 4 would require notable overlap with closely related skills, which is not evident here.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

rohitg00/agentmemory

Path

plugin/skills/write-agentmemory-skill/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.