CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-share

Promote a note from your personal Basic Memory project to a shared team project, with attribution. Use when the user says "share this with the team", "publish this decision", or runs /basic-memory:bm-share. This is the deliberate way to write to a team workspace — auto-capture never does.

72

Quality

89%

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

96%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 tight, well-sequenced instruction skill: every step is executable, risky writes are guarded by explicit confirmation and no-overwrite rules, and edge cases (empty config, UUID routing, missing arguments) are covered. The only structural note is that the config-precedence detail is inline in an already-dense first step rather than split out.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: every sentence carries execution-critical detail (config precedence rules, UUID routing via `project_id`, frontmatter fields to add, example confirmation and output lines). There is no explanation of concepts Claude already knows and no padding. Matches the anchor "every token earns its place".

5 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: exact config keys (`teamProjects`, `primaryProject`, `promoteFolder`), the routing rule ("if the team ref is an `external_id` UUID, pass it as `project_id`; otherwise pass the workspace-qualified name as `project`"), exact frontmatter field (`shared_from: <source permalink>`) and observation format, plus a sample output line. Per the rubric's scoring note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints around the risky write: stop if `teamProjects` is empty ("Don't invent a target"), confirm with the user before writing ("wait for a yes. Never share silently"), don't overwrite an existing note, and confirm the outcome with the new permalink. This matches the anchor's validate-before-proceed pattern with error paths (missing config, ambiguous source note) handled.

5 / 5

Progressive Disclosure

The body is well-organized (Steps / Notes) with no dangling references, and there are no bundle files to score against. Not 5 because the rubric reserves a 5 for skills under 50 lines needing no external references; this body is ~60 lines, and the config-resolution detail in step 1 (environment-variable handling, settings precedence) is dense enough that it could live in a reference file if the skill grew.

4 / 5

Total

19

/

20

Passed

Description

82%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 with explicit what/when structure, natural quoted trigger phrases, and explicit disambiguation from auto-capture. Its only deductions are the second-person possessive in the opening clause and trigger coverage that misses a few natural phrasing variants.

Suggestions

Rewrite the opening in third person to avoid the voice penalty, e.g. "Promotes a note from the personal Basic Memory project to a shared team project, with attribution."

Add one or two more natural trigger variants such as "share this note" or "send this to the team" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and a concrete action — "Promote a note from your personal Basic Memory project to a shared team project, with attribution" — which matches the anchor for 1-2 concrete actions without comprehensive coverage (no detail on how attribution works, what a team project is, or what the write does). Base specificity would be 4 given several implied actions (promote, attribute, write to team workspace), but the second-person possessive "your personal Basic Memory project" triggers the rubric's voice penalty, bringing it to 3. Not 2 because the action and domain are concrete, not generic like "Processes PDF files".

3 / 5

Completeness

Both parts are explicit: the "what" ("Promote a note from your personal Basic Memory project to a shared team project, with attribution") and the "when" ("Use when the user says 'share this with the team', 'publish this decision', or runs /basic-memory:bm-share"). This mirrors the anchor-5 example structure of what + concrete trigger phrases.

5 / 5

Trigger Term Quality

Quoted trigger phrases "share this with the team" and "publish this decision" are exactly what a user would naturally say, plus the explicit slash-command invocation "/basic-memory:bm-share". Not 5 because common variations like "share this note", "send this to the team", or "make this visible to teammates" are missing.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Basic Memory note promotion to a configured team project) with distinct quoted triggers, and it actively disambiguates from adjacent behavior — "This is the deliberate way to write to a team workspace — auto-capture never does" — minimizing conflict risk with sibling skills.

5 / 5

Total

17

/

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.