CtrlK
BlogDocsLog inGet started
Tessl Logo

agentmemory-rest-api

The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server. Use when calling agentmemory over HTTP, when MCP is unavailable and you need a fallback, or when integrating a host that does not speak MCP.

71

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

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

An exemplary lean, executable API-surface skill: copy-paste curl examples for the common operations, concrete auth and status-code conventions, and clean deferral of the bulk endpoint list. The two real weaknesses are a missing REFERENCE.md in the bundle (the primary deferred payload cannot actually be read) and the absence of any error-recovery guidance around the quick-start sequence.

Suggestions

Ship REFERENCE.md in the bundle (e.g., under references/) — the body defers the full endpoint list to it, but no such file exists, leaving the skill's core payload unreachable.

Add a two-line error-recovery note (e.g., 401 → AGENTMEMORY_SECRET not set / passed; connection refused → check --port or --instance) to close the validation loop in the Quick start.

DimensionReasoningScore

Conciseness

The ~40-line body is lean: five short sections, no explanation of REST/HTTP basics, and the one positioning sentence ("REST is agentmemory's primary surface. MCP is a bridge on top of it.") is project-specific knowledge Claude cannot infer. Every section earns its place; no over-explanation was found that would justify anchor 4.

5 / 5

Actionability

"curl -fsS http://localhost:3111/agentmemory/livez", the POST /remember and POST /smart-search examples with full JSON bodies, the concrete auth header ("Authorization: Bearer $AGENTMEMORY_SECRET"), and the 201/200/400 status conventions are copy-paste ready and cover the common cases (liveness, save, recall). Matches anchor 5.

5 / 5

Workflow Clarity

The Quick start sequences a liveness check before save/recall — an explicit validation checkpoint — and status-code conventions give feedback on outcomes. However, there is no error-recovery loop (e.g., 401 → AGENTMEMORY_SECRET not set; connection refused → wrong --port), which keeps it at anchor 4 ("most checkpoints present; minor validation gaps") rather than 5. It is a reference-style skill with no destructive or batch operations, so the workflow-clarity cap at 3 does not apply.

4 / 5

Progressive Disclosure

The body is a clean overview that defers bulk content appropriately ("The full endpoint list with methods lives in REFERENCE.md") with clearly signaled, one-level-deep references plus sibling-skill "See also" pointers. However, no bundle files exist (no references/, scripts/, or assets/ directories) and REFERENCE.md is not present anywhere in the bundle, so the skill's core payload — the full endpoint list — is unreachable. The structure itself is anchor-5 quality; the dangling primary reference is more than a minor organization gap but the in-file organization and signaling are solid, placing it between anchors 4 and 5, at 4.

4 / 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 well-crafted description with an explicit and multi-condition "Use when" clause, clear what-statement, and strong niche differentiation from the MCP surface. The main gap is specificity: it names the protocol surface but not the concrete memory operations the API performs.

Suggestions

Enumerate the core operations in the description itself (e.g., "save and recall memories over HTTP") so the 'what' names concrete actions rather than only the protocol surface.

Add natural trigger synonyms such as "REST endpoints", "HTTP API", or "curl" alongside "HTTP" and "MCP" to broaden keyword coverage.

Keep the third-person, declarative phrasing while doing the above — it is currently clean and free of filler.

DimensionReasoningScore

Specificity

"The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server" names the domain precisely and conveys one concrete action (HTTP calls to the memory server), but never enumerates what the API actually does (e.g., save, search, recall memories). It is above anchor 2 ("names the domain but actions are minimal or generic") because the protocol surface and role are sharply defined, but below anchor 4 because no specific operations are listed.

3 / 5

Completeness

The "what" is explicit ("The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server") and the "when" is explicit with three concrete trigger conditions in the "Use when..." clause. Both are answered clearly with concrete trigger phrases, matching the anchor-5 example's structure; anchor 4 would require the "when" to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger phrases "calling agentmemory over HTTP", "when MCP is unavailable and you need a fallback", and "integrating a host that does not speak MCP" are natural things a caller would say in this domain. Good coverage of agentmemory/HTTP/REST/MCP/fallback, but a few natural variants ("endpoints", "curl", "REST API reference") are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (REST/HTTP) and explicitly disambiguates from the sibling MCP path ("when MCP is unavailable and you need a fallback", "a host that does not speak MCP"). Minimal conflict risk with agentmemory-mcp-tools or agentmemory-config; it is clearly distinguishable.

5 / 5

Total

17

/

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
rohitg00/agentmemory
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.