bear-notes
Create, search, and manage Bear notes via grizzly CLI.
74
Quality
63%
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
40%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 identifies a clear niche (Bear notes via grizzly CLI) which makes it distinctive, but lacks completeness by omitting explicit trigger guidance. The specificity is moderate with some vague terms like 'manage', and trigger term coverage could be improved with more natural user phrases.
Suggestions
Add a 'Use when...' clause with trigger terms like 'Bear app', 'Bear notes', 'grizzly', or 'note-taking in Bear'
Replace vague 'manage' with specific actions like 'edit, delete, tag, archive, or export Bear notes'
Include natural phrases users might say such as 'find my notes', 'add a note to Bear', or 'organize Bear notes'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Bear notes) and lists three actions (create, search, manage), but 'manage' is vague and doesn't specify concrete operations like delete, archive, tag, or export. | 2 / 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. | 1 / 3 |
Trigger Term Quality | Includes 'Bear notes' and 'grizzly CLI' which are relevant, but misses common variations users might say like 'note-taking', 'Bear app', or specific actions like 'find my notes' or 'add a note'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct due to specific tool references (Bear, grizzly CLI). Unlikely to conflict with other note-taking skills since it explicitly names the proprietary app and CLI tool. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently documents the grizzly CLI for Bear notes. It excels at providing concrete, executable commands with appropriate organization. The main gap is the lack of validation steps or error handling guidance for operations that modify notes.
Suggestions
Add a brief note about how to verify a command succeeded (e.g., checking callback response or re-reading the note after modification)
Consider adding error handling guidance for common failure cases (Bear not running, invalid token, note not found)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, providing only necessary information without explaining what Bear is or how CLI tools work. Every section serves a clear purpose with no padding. | 3 / 3 |
Actionability | All commands are fully executable and copy-paste ready. The examples show real command patterns with actual flags and piping, not pseudocode. | 3 / 3 |
Workflow Clarity | Commands are clearly documented but there's no validation or error handling guidance. For operations that modify notes (add-text), there's no feedback loop to verify success or handle failures. | 2 / 3 |
Progressive Disclosure | For a skill of this size (~70 lines), the content is well-organized with clear sections (Commands, Options, Configuration, Notes). No external references needed and structure is easy to navigate. | 3 / 3 |
Total | 11 / 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
8763418
- 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.