CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

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

82%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 tight, highly executable API reference body with exemplary curl examples and a sensible auth-safe secret idiom, undermined only by its file layout: every promise of deeper detail (REFERENCE.md, TROUBLESHOOTING.md) resolves to a nonexistent file, so the skill's progressive-disclosure structure collapses at its first hop.

Suggestions

Create the referenced bundle files (REFERENCE.md with the endpoint list from src/triggers/api.ts, and TROUBLESHOOTING.md) or remove the links so no navigation path dead-ends.

Add a brief inline error-recovery note for failed curl calls (e.g., what a 401 vs 400 means and what to check) instead of relying solely on the missing TROUBLESHOOTING.md.

Include one or two additional endpoint examples inline (e.g., listing or deleting memories) so the quick start remains useful even while REFERENCE.md is being authored.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: "REST is agentmemory's primary surface. MCP is a bridge on top of it" and short sections (Quick start, Auth, Conventions, See also) with zero padding or explanations of concepts Claude already knows. Every token earns its place, matching the anchor "Lean and efficient; assumes Claude's competence". Not a 4 because there are no instances of over-explanation to trim.

5 / 5

Actionability

Fully executable, copy-paste-ready curl commands cover the common cases: livez check, bearer-auth POST to `/agentmemory/remember` and `/agentmemory/smart-search`, plus a working secret-loading idiom (`agentmemory_secret="${AGENTMEMORY_SECRET:-$(cat "$HOME/.agentmemory/secret")}"`). Matches the anchor "Fully executable; copy-paste ready code or commands; specific examples cover the common cases". Not a 4 because there are no gaps in the shown commands; not below 5 since the endpoints shown are concrete and complete.

5 / 5

Workflow Clarity

A coherent sequence is present (liveness check → load secret with an explicit guard `test -n "$agentmemory_secret" || exit 1` → save → recall), and status-code conventions ("Save returns `201`, reads return `200`, validation errors return `400`") act as implicit checkpoints. Matches "Clear sequence with most checkpoints present; minor validation gaps". Not a 5 because error recovery is delegated to a TROUBLESHOOTING.md link that does not exist, leaving a missing feedback loop; not a 3 because the sequence and the secret guard are explicit, and this is not a destructive/batch operation requiring the level-3 cap.

4 / 5

Progressive Disclosure

Sections are well-signaled, but the only deep-dive pointers — "See [TROUBLESHOOTING.md](TROUBLESHOOTING.md)" and "The full endpoint list with methods lives in REFERENCE.md" — point to files that do not exist anywhere in the bundle (no references/, scripts/, or assets/ directories). Scoring against the actual bundle structure, navigation is broken: the reference surface the skill defers to is missing. Matches the anchor "Minimal structure; ... references are buried" in effect, since the promised reference layer is absent. Not a 3 because the problem is not unclear signaling but dangling references; not a 1 because the body itself is well organized with no nested chains.

2 / 5

Total

16

/

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 that clearly answers both what and when, with explicit REST-vs-MCP disambiguation that minimizes conflict risk. Its only weakness is abstraction: it names the API surface rather than the concrete memory operations it covers.

Suggestions

Add one or two concrete operations to the 'what' clause (e.g., "save and recall memories via HTTP endpoints") to lift specificity.

Mention the endpoint names or "REST endpoints" as natural trigger terms users might use when invoking this skill.

DimensionReasoningScore

Specificity

The domain is clearly named — "The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server" — with one concrete action implied ("calling agentmemory over HTTP"), but no specific operations (remember, search, endpoints) are listed. Matches the anchor "Names domain and 1-2 concrete actions, but not comprehensive". Not a 4 because it describes what the surface is rather than several specific actions it enables; not a 2 because the domain is named precisely, not minimally.

3 / 5

Completeness

Both questions are answered explicitly: what — "The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server"; when — "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", with three concrete trigger phrases. Matches the anchor "Clearly and explicitly answers both what AND when with concrete trigger phrases". Not a 4 because the 'when' clause is already fully explicit and multi-scenario, not merely adequate.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "calling agentmemory over HTTP", "MCP is unavailable and you need a fallback", "integrating a host that does not speak MCP" — phrases a user would plausibly say in exactly those situations. Matches "Good keyword coverage; a few natural terms missing". Not a 5 because terms like "endpoints", "curl", or the concrete operation names (save/recall) that a user might naturally use are absent; not a 3 because the included terms are natural, not jargon-only.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche and actively disambiguates from the sibling MCP skill via the conditions "when MCP is unavailable and you need a fallback, or when integrating a host that does not speak MCP". Matches "Clear niche with distinct triggers; minimal conflict risk". Not a 4 because the MCP-vs-REST boundary is stated in the description itself, leaving little overlap ambiguity.

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/agentmemory-rest-api/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.