bear-notes

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

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/bear-notes/SKILL.md

Quality

Content

80%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 highly actionable with executable grizzly commands and clean section organization, but it lacks validation checkpoints for mutating operations and carries an irrelevant migration note that adds noise.

Suggestions

Remove or relocate the 'PilotDeck Migration Note' section; it is review metadata unrelated to using the skill.

Add a validation step after token setup (e.g. run a read command to confirm the token works) and a checkpoint after append/add-text operations.

Show how to capture and confirm the returned note ID from create before using it in subsequent commands.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with executable commands and no over-explanation of concepts, but the trailing 'PilotDeck Migration Note' section is irrelevant padding that does not help Claude use the skill.	4 / 5
Actionability	Commands like `grizzly create --title "My Note" --tag work` and `grizzly open-note --id "NOTE_ID" --enable-callback --json` are copy-paste ready and cover the common cases with real flags.	5 / 5
Workflow Clarity	Commands are organized by task, but token setup is a multi-step process without verification and the add-text append operation (a mutating/batch-style action) lacks validation checkpoints, capping workflow clarity at 3.	3 / 5
Progressive Disclosure	The skill is under 50 lines with no bundle files, and the body is well-organized into clearly headed sections, matching the simple-skill exception for a 5.	5 / 5
	Total	17 / 20 Passed

Description

66%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 is specific and names a distinct niche with concrete actions, but it omits any explicit 'Use when' trigger guidance, which is the main thing holding back completeness and trigger discoverability.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when creating, searching, or managing notes in Bear on macOS.'

Include natural synonyms like 'markdown notes' to broaden trigger coverage.

Drop the tool name from the lead clause or relegate it, leading with the user-facing outcome.

Dimension	Reasoning	Score
Specificity	"Create, search, and manage Bear notes via grizzly CLI" names a specific domain and three concrete actions with the tool that performs them, with only minor gaps in coverage.	4 / 5
Completeness	The what is clear ("Create, search, and manage Bear notes"), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Natural terms like "Bear notes", "search", and "create" appear, but synonyms and the .md file-extension cue are absent and "grizzly CLI" is tool jargon rather than user language.	4 / 5
Distinctiveness Conflict Risk	Bear notes via grizzly is a clear niche with distinct triggers and minimal overlap with other skills, though it does not fully spell out the trigger boundary.	4 / 5
	Total	15 / 20 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: OpenBMB/PilotDeck
Path: skills/bear-notes/SKILL.md
Commit: 1104fd9

Reviewed: about 6 hours 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.