OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
72
62%
Does it follow best practices?
Impact
92%
2.09xAverage score across 3 eval scenarios
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./extensions/open-prose/skills/prose/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 specific tool ecosystem (OpenProse) and provides activation triggers, but critically fails to explain what the skill actually does in concrete terms. 'Orchestrates multi-agent workflows' is vague buzzword language that gives Claude no basis for understanding when this skill would be more appropriate than alternatives. The description needs specific capability verbs and clearer use-case guidance.
Suggestions
Replace 'orchestrates multi-agent workflows' with specific concrete actions the skill performs (e.g., 'Parses .prose workflow definitions, spawns agent tasks, manages execution pipelines, and returns aggregated results').
Expand the 'when' clause to include natural user phrases beyond just file extensions and commands (e.g., 'Use when the user wants to run OpenProse pipelines, execute .prose workflow files, or coordinate multi-step agent tasks').
Add a brief explanation of what OpenProse is so Claude can distinguish this from general prose/writing tasks (e.g., 'OpenProse is a workflow definition language for multi-agent task orchestration').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says it 'orchestrates multi-agent workflows' but never specifies what concrete actions it performs. There are no specific capabilities listed—no verbs describing what it actually does with prose or what outcomes it produces. | 1 / 3 |
Completeness | It partially answers 'when' with 'Activate on any prose command, .prose files, or OpenProse mentions' but the 'what' is extremely vague—'orchestrates multi-agent workflows' tells nothing about what the skill actually accomplishes. The when clause exists but the what is too weak. | 2 / 3 |
Trigger Term Quality | It includes some trigger terms like 'prose command', '.prose files', and 'OpenProse mentions', which are relevant for matching. However, these are fairly niche/technical terms and it lacks natural language variations a user might say (e.g., 'writing', 'editing', 'text generation'). | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'OpenProse', '.prose files', and 'prose command' provides some distinctiveness tied to a specific tool/format. However, 'multi-agent workflows' is generic enough to potentially overlap with other orchestration skills, and 'prose' alone could conflict with general writing skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
85%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-structured orchestration skill that effectively serves as a routing hub for a complex multi-file system. Its strengths are excellent progressive disclosure with clear load-on-demand signals, concrete actionable guidance throughout, and well-sequenced workflows with validation steps. Its main weakness is moderate redundancy in file location documentation (listed in multiple overlapping tables) and some verbosity in the PostgreSQL setup section that could be deferred to the referenced state/postgres.md file.
Suggestions
Consolidate the 'File Locations' and 'Core Documentation' tables into a single table with columns for file, purpose, and when-to-load to eliminate redundancy.
Move the detailed PostgreSQL Docker setup commands into state/postgres.md and keep only the high-level check-and-advise flow in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~250 lines) with some redundancy—file locations are listed in multiple tables (File Locations, Core Documentation) with overlapping information. The state modes section is thorough but verbose, especially the PostgreSQL setup instructions which include Docker commands and multi-step verification. However, most content is genuinely needed for routing and execution logic, so it's not egregiously padded. | 2 / 3 |
Actionability | The skill provides concrete command routing tables, specific file paths, executable bash commands for state setup, exact migration steps with before/after examples, resolution rules for remote programs, and a clear execution sequence. The guidance is specific and copy-paste ready throughout. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints: the PostgreSQL setup has a 4-step verify-then-proceed flow, migration has numbered steps with specific outputs for success/no-op cases, and execution has a clear 5-step sequence. The remote program resolution has explicit rules table. Error recovery paths are specified (e.g., fallback to filesystem state if sqlite3/postgres unavailable). | 3 / 3 |
Progressive Disclosure | The skill is an excellent routing document—it clearly signals when to load each referenced file (prose.md, compiler.md, help.md, state backends, guidance files) with explicit 'When to Load' conditions. Content is appropriately split across referenced files with one-level-deep navigation. The context warning about compiler.md size shows awareness of token budget. The file location tables provide clear navigation. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 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 |
Total | 9 / 11 Passed | |
b4fc4af
Table of Contents
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.