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.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

100%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is dense, executable, and well-sequenced, with concrete MCP query parameters and explicit guardrails for missing setup. As a compact single-purpose skill with no bundle files, it is appropriately self-contained and earns top marks across all dimensions.

Dimension	Reasoning	Score
Conciseness	A lean ~50-line body that assumes Claude's competence and contains no padding explaining concepts Claude already knows; every line instructs an action.	3 / 3
Actionability	Provides concrete, copy-paste-ready guidance — the `search_notes` tool call with exact `metadata_filters` JSON, named config fields, and precise config-precedence rules — rather than abstract direction.	3 / 3
Workflow Clarity	A clear five-step sequence with explicit validation checkpoints (report incomplete setup when config/repo is missing, never run unscoped coding-session queries, do not write to shared projects) providing feedback loops for error recovery.	3 / 3
Progressive Disclosure	A simple, single-purpose skill under 50 lines with no external references; it is well-organized into clearly headed sections, which per the scoring notes earns the top anchor without bundle files.	3 / 3
	Total	12 / 12 Passed

Description

100%Weight 40%Scale 1-3

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 concise, third-person description that covers what the skill does, when to use it, and stays in a distinct niche. It hits the top anchor on all four dimensions with no fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Enumerates multiple concrete actions — 'reading active tasks, open decisions, recent checkpoints, and repo conventions' — rather than naming only a domain, matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	Explicitly answers both 'what' (orient by reading tasks/decisions/checkpoints/conventions) and 'when' ('Use when resuming old work or when the user asks where things stand'), satisfying the explicit-trigger anchor.	3 / 3
Trigger Term Quality	Includes natural phrases users would actually say — 'resuming old work' and 'when the user asks where things stand' — giving good coverage of natural triggers.	3 / 3
Distinctiveness Conflict Risk	A clear niche — Basic Memory orientation — with distinct triggers tied to resuming work and status checks, making it unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: basicmachines-co/basic-memory
Path: plugins/claude-code/skills/bm-orient/SKILL.md
Commit: 60408ad

Reviewed: 11 days ago

Table of Contents

Discovery Implementation Validation

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.