11 tools with complete JSON schemas and descriptions, but significant quality gaps. All tools have descriptions (10-100 chars, mostly 50-80 chars), and all expose input schemas with type definitions. However, naming lacks action verbs (e.g., 'aliases', 'bases', 'bookmarks' are nouns, not verb_noun patterns like 'list_aliases'). Parameter descriptions are minimal (5-30 chars) and lack actionable constraints. No output schemas documented. Error handling and recovery guidance absent. Tool composition is reasonable (single responsibility), but descriptions don't explain WHEN to use each tool or what it returns. Schemas are present but sparse, many parameters lack min/max bounds, format hints, or dependency documentation.
List aliases in the vault CLI command: obsidian aliases
Append content to a file CLI command: obsidian append
List backlinks to a file CLI command: obsidian backlinks
Create a new item in a base CLI command: obsidian base:create
Query a base and return results CLI command: obsidian base:query
List views in the current base file CLI command: obsidian base:views
List all base files in vault CLI command: obsidian bases
Add a bookmark CLI command: obsidian bookmark
Tool names lack action verbs. 'aliases', 'bases', 'bookmarks' are nouns; should be 'list_aliases', 'list_bases', 'list_bookmarks'. LLMs infer intent from verb_noun patterns, noun-only names force extra reasoning.
Parameter descriptions are minimal (5-30 chars) and lack actionable constraints. E.g., 'File name' does not explain format, length, or allowed characters. 'Include file paths' does not clarify what 'verbose' actually returns.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. E.g., 'aliases' returns what structure? Array of strings? Objects with metadata? Unknown.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
List bookmarks CLI command: obsidian bookmarks
Execute an Obsidian command CLI command: obsidian command
List available commands CLI command: obsidian commands
No error handling or recovery guidance. If 'append' fails (file not found, permission denied), the LLM has no guidance on what to do next. No categorization of retryable vs fatal errors.
Numeric and enum parameters lack bounds or constraints. E.g., no min/max for pagination limits, no enum values for 'format' in base.query (though enum is present in schema, description does not reinforce it).