bear-notes
Create, search, and manage Bear notes via grizzly CLI.
72
61%
Does it follow best practices?
Impact
100%
3.57xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/bear-notes/SKILL.mdQuality
Discovery
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 is concise and names specific actions (create, search, manage) tied to a clear domain (Bear notes via grizzly CLI), giving it strong specificity and distinctiveness. However, it lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill, and it could benefit from additional natural trigger terms users might use.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to create, find, or organize notes in Bear, or mentions Bear app, grizzly, or note management.'
Include additional natural trigger terms like 'Bear app', 'note-taking', 'find notes', 'add note', or 'organize notes' to improve keyword coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create, search, and manage Bear notes' and specifies the tool used ('grizzly CLI'). These are clear, actionable verbs tied to a specific domain. | 3 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores at 1. | 1 / 3 |
Trigger Term Quality | Includes 'Bear notes' and 'grizzly CLI' which are relevant keywords, but misses common variations users might say like 'note-taking', 'Bear app', or specific actions like 'find notes', 'add note', 'open Bear'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche — Bear notes via grizzly CLI is highly specific and unlikely to conflict with other skills. The combination of the Bear app and grizzly CLI tool creates a clear, unique trigger space. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid CLI reference skill with excellent actionability—every command is concrete and executable. The main weaknesses are minor verbosity (redundant notes section, some repeated token information) and the lack of validation steps after operations like creating or appending to notes. Overall it serves its purpose well as a quick reference for the grizzly CLI.
Suggestions
Remove the redundant 'Notes' section at the bottom, as its points are already covered inline (token requirements, callback usage).
Add a brief verification step after create/add-text commands, e.g., 'Verify with: grizzly open-note --id "NOTE_ID" --enable-callback --json' to confirm the operation succeeded.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but has some unnecessary explanation. The 'Notes' section at the bottom repeats information already covered (token requirements, callback usage). The configuration section is somewhat verbose for what could be a simpler reference. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready bash commands for all common operations. The token setup instructions are concrete with exact steps. Every command example is specific and runnable. | 3 / 3 |
Workflow Clarity | The token setup is a clear sequence, and individual commands are well-documented, but there's no validation or error handling guidance. For operations that modify notes (add-text, create), there are no verification steps to confirm success. | 2 / 3 |
Progressive Disclosure | For a skill of this size and scope (single CLI tool reference), the content is well-organized into logical sections (setup, commands, options, configuration) without needing external file references. Navigation is clear with descriptive headers. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- trpc-group/trpc-agent-go
- Commit
0c1ec2b
- 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.