CtrlK
BlogDocsLog inGet started
Tessl Logo

bear-notes

Create, search, and manage Bear notes via grizzly CLI.

54

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/bear-notes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The content is highly actionable with clean executable commands and good organization, but loses points for repeated token guidance, an off-topic migration section, and missing validation steps for mutating operations. Tightening redundancy and adding verify steps would raise it.

Suggestions

State the token requirement once and reference it, removing the duplicated explanations in 'Getting a Bear Token', 'Common Commands', and 'Notes'.

Remove or relocate the 'PilotDeck Migration Note' section, which is unrelated to executing the skill.

Add an explicit verification step after mutating operations (e.g. re-open the note with grizzly open-note to confirm appended text).

DimensionReasoningScore

Conciseness

The body is mostly lean and avoids explaining what Bear is, but the token requirement is repeated three times and the 'PilotDeck Migration Note' section is unrelated padding that does not earn its tokens.

2 / 3

Actionability

Concrete, executable grizzly commands with real flags and examples are provided throughout, making them copy-paste ready.

3 / 3

Workflow Clarity

Commands are organized into clearly labeled sections, but there is no explicit multi-step sequencing or validation checkpoint for mutating operations like add-text.

2 / 3

Progressive Disclosure

A single cohesive SKILL.md is organized into clear, well-signaled sections with no nested or misplaced references, appropriate for a self-contained skill.

3 / 3

Total

10

/

12

Passed

Description

50%

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 names its niche and tool, but is generic in its action verbs and lacks an explicit activation trigger, capping several dimensions at 2. Adding a 'Use when...' clause and more specific actions would lift it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to create, find, tag, or append to notes in Bear on macOS.'

Replace the vague verb 'manage' with concrete actions like 'create, append to, tag, and search notes'.

Include natural keyword variations such as 'Bear app', 'take a note', and 'find notes' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (Bear notes) and three actions (create, search, manage) plus the grizzly CLI, but 'manage' is vague and the action list is not comprehensive.

2 / 3

Completeness

It states what the skill does but has no 'Use when...' trigger clause, so the 'when' is only implied and completeness is capped at 2.

2 / 3

Trigger Term Quality

'Bear notes' and 'search' are relevant keywords, but natural variations like 'Bear app', 'take a note', or 'find notes' are missing.

2 / 3

Distinctiveness Conflict Risk

The Bear/grizzly niche is fairly specific, but the thin trigger guidance and generic 'manage' verb leave some overlap risk with general note-taking skills.

2 / 3

Total

8

/

12

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.

Validation15 / 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
OpenBMB/PilotDeck
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.