CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-orient

Orient Claude from Basic Memory before substantial repo work by reading active tasks, open decisions, recent checkpoints, and repo conventions. Use when resuming old work or when the user asks where things stand.

68

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

78%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, highly actionable instruction-only skill: every step names concrete tools, filters, and config keys, with explicit failure handling for incomplete setup. The main deductions are mild redundancy in step 2's prose restatement and unspecified details (which tool to read notes with, and the permalink format) in steps 4-6.

Suggestions

Collapse the step 2 prose that restates the bullet rules ('Always query... Never run an unscoped coding-session query...') into one or two clauses, since the bullets already encode the rules.

Name the note-reading tool and show a one-line permalink example in step 4 so 'read the highest-signal hits' and 'include permalinks' are fully executable.

Trim the intro paragraph, which repeats the frontmatter description almost verbatim, to a single sentence distinguishing this from the SessionStart hook briefing.

DimensionReasoningScore

Conciseness

The body is dense but nearly every token carries real, non-inferable constraints (hook config precedence, 'external_id' UUID handling, the lifecycle-trace exclusion). It is not 5 because step 2 states the coding-session rules twice — once in the bullet list and again in prose ('Always query... include coding_session... Never run an unscoped...') — and the intro paragraph re-states the description, which could be trimmed.

4 / 5

Actionability

Concrete, executable guidance throughout: the exact tool call 'search_notes' with literal 'metadata_filters' JSON per query, the six config keys, and explicit precedence rules. It is not 5 because step 4 says 'read the highest-signal hits' without naming the read tool or the expected permalink format, leaving small execution gaps.

4 / 5

Workflow Clarity

A clear five-step sequence with explicit error paths — 'if the repository is missing, report that setup is incomplete', 'mention that setup has not been run', and surfacing 'any missing setup or ambiguous project mapping' in the output. It is not 5 because there is no validate→fix→retry analogue (e.g., re-checking the merged checkpoint list), and not 3 because checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

The skill is short (~40 lines of prose) with no bundle files and nothing that clearly belongs in a separate file; the title, intro, and '## Steps' sections are well-organized and self-contained. Per the simple-skill scoring note ('under 50 lines with no need for external references... can score 5 with just well-organized sections'), this fits the top anchor.

5 / 5

Total

17

/

20

Passed

Description

88%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 names the domain, enumerates four concrete read actions, and gives explicit 'Use when...' triggers in third-person voice. The only gaps are a few missing natural synonyms for the resume/catch-up intent and slight breadth from 'before substantial repo work'.

Suggestions

Add a natural synonym or two to the trigger clause (e.g., 'or when the user asks to catch up on where a project left off') so more phrasings of the intent match.

Narrow the 'before substantial repo work' trigger (e.g., 'in a Basic Memory-linked project') to reduce overlap with generic session-start skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "reading active tasks, open decisions, recent checkpoints, and repo conventions" — comprehensively covering what the orientation does, matching the anchor 'lists multiple specific concrete actions; comprehensive coverage'. It is not 4 because coverage shows no minor gaps.

5 / 5

Completeness

Both halves are explicit: what — "Orient Claude from Basic Memory... by reading active tasks, open decisions, recent checkpoints, and repo conventions"; when — "Use when resuming old work or when the user asks where things stand". This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "resuming old work", "where things stand", "active tasks", "open decisions" — but common variations ("catch up", "get up to speed", "brief me on the project") are missing. It is not 3 because keyword coverage is genuinely good, not merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The Basic Memory niche and its triggers ("resuming old work", "where things stand") are distinct, but "before substantial repo work" leaves minor overlap risk with generic session-start/context-recovery skills — matching 'mostly distinct; minor overlap risk with closely related skills' rather than the clear-niche anchor 5.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
basicmachines-co/basic-memory
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.