CtrlK
BlogDocsLog inGet started
Tessl Logo

letta-guide

Read the official Letta documentation (docs.letta.com) through its cached, ETag-checked fetch route. Load before ANY docs.letta.com retrieval — answering how Letta works, what Letta (or you) can do, and looking up Letta API, Agent SDK, or Letta Code reference.

72

Quality

88%

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 tightly written operational guide: an ordered fetch route with explicit failure handling and disclosure rules, concrete executable commands, and hard rules against inventing product details. Its only imperfections are slight motivational padding in the intro and two short reference-style sections (CLI commands, support links) inlined in SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense and instructional throughout: ordered route steps, an applies_to example, exact CLI commands, and hard rules. Minor instances of over-explanation could be trimmed — e.g., "Users lose trust fastest when an agent confidently invents product details" and the rationale in "Guessing a docs URL and fetching it with `fetch_webpage` misses pages..." — so it is not anchor 5's "every token earns its place", but it is well above the anchor-3 "some unnecessary explanation".

4 / 5

Actionability

Commands are copy-paste ready: `node <SKILL_DIR>/scripts/fetch-letta-docs.mjs`, the `--docs-url "https://docs.letta.com/configuration/models/index.md"` example, and concrete CLI commands like `letta model set [model_handle] [--reasoning <reasoning-option>] [--default]`. The fallback is equally specific ("use `fetch_webpage` only as a fallback with a fresh query parameter... Disclose that the fallback may be stale"), and the referenced script exists with the described flags. This matches anchor 5's fully-executable, common-cases-covered bar.

5 / 5

Workflow Clarity

"Source route (in order)" numbers 1-4 with an explicit escalation ladder: self-inspection, fetch index, fetch the exact canonical URL from the index, then "If direct retrieval fails, use `fetch_webpage` only as a fallback with a fresh query parameter... If that also fails, say the docs are unreachable" — a clear sequence with validation checkpoints (ETag verification, reading frontmatter "before applying its instructions") and an error-recovery feedback loop. Not anchor 4, because checkpoints are explicit rather than having minor gaps.

5 / 5

Progressive Disclosure

Good structure: the body is a well-sectioned overview and its one reference — `scripts/fetch-letta-docs.mjs` — is real, one level deep, and directly invoked. It is not anchor 5's "content appropriately split" because a couple of inline sections ("Inspect or change your model from the CLI" command reference and the "Support escalation" link list) are reference-style content living in SKILL.md; they are short enough that this is a minor organization gap rather than the anchor-3 problem of large inline reference blocks.

4 / 5

Total

18

/

20

Passed

Description

87%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: it states a single concrete capability (reading Letta's docs via a cached, ETag-checked route) and gives an explicit, enumerative load-before trigger covering questions and reference lookups across Letta's surfaces. The only softness is minor missing trigger synonyms, which keeps two dimensions at 4 rather than 5.

DimensionReasoningScore

Specificity

Quotes: "Read the official Letta documentation (docs.letta.com) through its cached, ETag-checked fetch route" and the enumerated lookup areas "Letta API, Agent SDK, or Letta Code reference". The action is concretely specified with its mechanism (cached, ETag-checked route) and coverage spans several named surfaces, which is noticeably above the anchor-3 example ("Processes PDF files and extracts content"); it falls short of anchor 5 only because the skill inherently performs one fetch-and-read action rather than 'multiple specific concrete actions'.

4 / 5

Completeness

Quotes: what — "Read the official Letta documentation (docs.letta.com) through its cached, ETag-checked fetch route"; when — "Load before ANY docs.letta.com retrieval — answering how Letta works, what Letta (or you) can do, and looking up Letta API, Agent SDK, or Letta Code reference". Both what and when are explicitly and clearly stated with concrete trigger phrases, matching the anchor-5 example pattern exactly; it is not anchor 4 because the 'when' clause is not merely present but specific and enumerative.

5 / 5

Trigger Term Quality

Quotes: "answering how Letta works, what Letta (or you) can do, and looking up Letta API, Agent SDK, or Letta Code reference" plus "docs.letta.com". These are natural phrases users would say, with good coverage of the product's surfaces; a few common variations (e.g., "Letta docs", "letta CLI", "Letta guide") are absent, keeping it below the anchor-5 "comprehensive coverage including synonyms and file extensions".

4 / 5

Distinctiveness Conflict Risk

Quotes: "the official Letta documentation (docs.letta.com)", "Letta API, Agent SDK, or Letta Code reference". The niche is unambiguous — fetching Letta's own docs — and every trigger is Letta-branded, so overlap with other skills is minimal; this matches anchor 5's "clear niche with distinct triggers" and there is no neighboring anchor it fits better.

5 / 5

Total

18

/

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
letta-ai/letta-code
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.