bm-setup

Set up Basic Memory for Codex at user or project level by mapping a Basic Memory project and seeding schemas.

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/codex/skills/bm-setup/SKILL.md

Quality

Content

75%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 content is well-structured, actionable, and workflow-oriented with strong verification steps and concrete config examples. Minor tightening of repeated caveats and a touch more progressive disclosure could push it higher.

Dimension	Reasoning	Score
Conciseness	The body is dense and instructional with little wasted explanation, assuming Claude's knowledge, though the long interview list and repeated caveats could be tightened slightly.	4 / 5
Actionability	Provides concrete config JSON blocks, exact TOML snippets, schema file names, and specific CLI commands; minor gaps are placeholder values the skill instructs the user to confirm.	4 / 5
Workflow Clarity	Clear Preconditions -> Interview -> Apply -> Seed Schemas -> Verify sequence with a dedicated verification section and error-recovery guidance, missing only a few explicit validate-fix-retry feedback loops.	4 / 5
Progressive Disclosure	Well-organized into clear sections with one-level-deep references to schema files under <plugin-root>/schemas/; the body is moderately long but appropriately self-contained with only the icon.svg asset.	4 / 5
	Total	16 / 20 Passed

Description

50%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 clearly states what the skill does but lacks any 'when to use it' trigger guidance, which the rubric treats as a significant gap. Trigger term coverage is also limited.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases (e.g., 'Use when setting up Basic Memory for Codex, configuring a Basic Memory project, or seeding Codex session schemas').

Include natural synonyms and variations a user might actually say, such as 'connect Basic Memory to Codex' or 'configure bm for Codex'.

Consider naming additional concrete actions (e.g., configuring capture/checkpoint behavior) to lift specificity from a strong 4 toward 5.

Dimension	Reasoning	Score
Specificity	Names the concrete actions of mapping a Basic Memory project and seeding schemas at user or project level; coverage is solid but limited to two actions rather than a comprehensive list.	4 / 5
Completeness	Has a clear 'what' but entirely omits a 'Use when...' clause or any explicit trigger guidance, which the rubric caps at 3 and the absence pushes toward 2.	2 / 5
Trigger Term Quality	Uses the domain phrase 'Basic Memory for Codex' but lacks common natural trigger variations or synonyms a user would say, so keyword coverage is partial.	3 / 5
Distinctiveness Conflict Risk	The niche of setting up Basic Memory for Codex is distinct with minimal overlap risk, though it could marginally overlap with a generic Codex-config skill.	4 / 5
	Total	13 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: basicmachines-co/basic-memory
Path: plugins/codex/skills/bm-setup/SKILL.md
Commit: a5fb68e

Reviewed: 3 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.