CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-plugin-thin

Adapter boundary rules for plugin integrations. Trigger: Changes in plugin scripts/hooks for Claude, OpenCode, Pi, Gemini, or Codex.

Quality

83%

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

93%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 an exemplary lean, instruction-only rules skill: boundary rules are terse directives, and the Pi exception protocol is fully specified with exact endpoints, error codes, timings, and success criteria that could be implemented verbatim. The only soft spot is the Compatibility Checklist, which names verification outcomes without saying how to verify them.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence throughout: "Keep adapters thin: parse input, call API/tool, return" is a complete rule in one line, and no section explains concepts Claude already knows. Even the densest part (the Pi exception) carries only binding specifics — endpoint, error codes, timings, status values — with every token earning its place, matching anchor 5 rather than anchor 4's "minor instances that could be trimmed".

5 / 5

Actionability

The guidance is fully implementable without code: it names the exact endpoint ("GET /observations/save-result"), the typed error ("404 with code observation_save_result_not_found"), the timing bound ("cancellable 250 ms backoff"), and the success criteria ("a positive ID and status: \"committed\"" and "legacy positive {id} acknowledgement"). Per the rubric's instruction-only note, the absence of code is not penalized when guidance is this actionable, and the common cases (initial success, ambiguity, typed HTTP errors, caller cancellation) are all covered, so it meets anchor 5 rather than stopping at anchor 4's "minor gaps".

5 / 5

Workflow Clarity

The Pi recovery protocol is a clearly sequenced decision tree with an explicit validation checkpoint ("A lookup confirms success only with a positive ID and status: \"committed\""), but the Compatibility Checklist items ("Claude Code flow still works") state outcomes without any concrete verification method, which is exactly anchor 4's "minor validation gaps". It stays above anchor 3 because the risky recovery flow does have explicit checkpoints and error-recovery branching.

4 / 5

Progressive Disclosure

The body is under 50 lines, needs no external references (none exist in the bundle), and is organized into four clearly delineated sections (When to Use, Boundary Rules, the narrow Pi exception, Compatibility Checklist). The dense Pi exception is a single coherent ~24-line spec that is appropriately inline, so per the simple-skill guideline this matches anchor 5.

5 / 5

Total

19

/

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 has an explicit, well-targeted trigger clause naming five specific agents, which gives it good discoverability and low conflict risk. Its main weakness is the "what" half: "Adapter boundary rules for plugin integrations" names a domain but no concrete actions, leaving a reader unable to tell what the skill actually directs Claude to do.

Suggestions

Replace the abstract first sentence with concrete actions, e.g. "Keep plugin adapters thin — parse input, call the API/tool, return — and move complex logic into the Go core (store/server/mcp)."

Add the key domain nouns a contributor would actually say as trigger terms, e.g. "memory capture" or "agent integrations", alongside "plugin scripts/hooks".

Mention the distinguishing constraints in the description itself (no extra runtime dependencies, one shared contract across agents) so the skill's scope is clear before the body is read.

DimensionReasoningScore

Specificity

The description names the domain ("Adapter boundary rules for plugin integrations") but lists no concrete actions — it says what the skill contains, not what it does. Anchor 3 requires 1-2 named actions (cf. "Processes PDF files and extracts content") and none are present; it is above anchor 1 because the domain itself is specifically named rather than pure abstraction.

2 / 5

Completeness

Both halves are present: a "what" ("Adapter boundary rules for plugin integrations") and an explicit "when" ("Trigger: Changes in plugin scripts/hooks for Claude, OpenCode, Pi, Gemini, or Codex"), so the missing-trigger cap of 3 does not apply. It is not anchor 5 because the "what" states no concrete actions or outcomes (e.g., keeping adapters thin, routing logic to the Go core), leaving the capability description thin.

4 / 5

Trigger Term Quality

"Changes in plugin scripts/hooks for Claude, OpenCode, Pi, Gemini, or Codex" gives good natural keyword coverage — users editing agent plugin hooks would plausibly say "plugin", "hooks", "scripts", or one of the five agent names. It falls short of anchor 5's comprehensive synonym coverage (e.g., "adapters", "memory capture", "agent integrations" are absent as trigger phrases), but clearly exceeds anchor 3 because the main variations are covered via the agent names.

4 / 5

Distinctiveness Conflict Risk

The trigger is narrowed by five named agents and the specific artifacts "plugin scripts/hooks", giving a clear niche with minor overlap risk against generic plugin-authoring guidance. Not anchor 5: "plugin integrations" in the first sentence is still broad enough to collide with general plugin-development skills.

4 / 5

Total

14

/

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

Gentleman-Programming/engram

Path

skills/plugin-thin/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.