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 is too vague about what the skill actually does — 'orchestrates multi-agent workflows' provides no concrete understanding of capabilities. While it includes some specific trigger terms (.prose files, prose command, OpenProse), it lacks natural user language and fails to clearly explain the skill's purpose or output.
Suggestions
Replace 'orchestrates multi-agent workflows' with specific concrete actions the skill performs (e.g., 'generates, edits, and reviews prose documents using multi-agent collaboration').
Add a clear 'Use when...' clause with natural trigger terms users might say, such as 'writing', 'editing', 'prose generation', or whatever the actual use cases are.
Clarify what 'OpenProse VM skill pack' means in practical terms — what problem does it solve and what output does it produce?
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says it 'orchestrates multi-agent workflows' but never lists concrete actions like 'generates drafts', 'edits text', 'reviews grammar', etc. 'Skill pack' and 'orchestrates' are vague and abstract. | 1 / 3 |
Completeness | The 'when' is partially addressed via 'Activate on any prose command, .prose files, or OpenProse mentions', but the 'what' is extremely weak — 'orchestrates multi-agent workflows' tells Claude almost nothing about what the skill actually does or produces. | 2 / 3 |
Trigger Term Quality | It includes some useful trigger terms like 'prose command', '.prose files', and 'OpenProse mentions', but these are tool-specific jargon rather than natural user language. It lacks common variations of what users might actually say when needing prose/writing help. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'OpenProse', '.prose files', and the `prose` command provides some distinctiveness, but 'multi-agent workflows' is generic enough to overlap with other orchestration or agent-related skills. The niche is somewhat defined but not sharply. | 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 excels at progressive disclosure and actionability—it serves as a clear routing hub for a complex multi-file system with concrete commands, resolution rules, and validation steps. Its main weakness is moderate redundancy across multiple file-location tables and some philosophical framing that doesn't add operational value. Overall it's a strong skill that effectively guides Claude through a complex domain.
Suggestions
Consolidate the three overlapping file-location tables (File Locations, Core Documentation, and State Modes) into a single reference table with a 'When to Load' column to reduce redundancy.
Remove or drastically shorten the philosophical opening paragraph ('LLMs are simulators...simulation with sufficient fidelity is implementation')—this doesn't add actionable guidance.
| 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 conceptual framing ('LLMs are simulators', 'simulation with sufficient fidelity is implementation') is philosophical padding. However, most content is reference tables and concrete instructions, so it's not egregiously verbose. | 2 / 3 |
Actionability | The skill provides concrete command routing tables, specific file paths, executable bash/code snippets for PostgreSQL setup, migration steps with exact input/output formats, and clear resolution rules for remote programs. Commands are copy-paste ready and the routing table leaves little ambiguity about what action to take. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints: PostgreSQL setup has a 4-step flow with connectivity verification before proceeding, migration has numbered steps with clear before/after states and output formatting, and execution has a 5-step numbered sequence. The PostgreSQL flow includes fallback behavior on failure, and migration includes both success and no-op output states. | 3 / 3 |
Progressive Disclosure | The skill is an excellent routing document—it clearly signals when to load each companion file (prose.md, compiler.md, help.md, state backends, guidance files) with explicit 'When to Load' conditions. References are one level deep, well-organized in tables, and the context warning about compiler.md size shows awareness of token budget. The examples directory is summarized with keyword lookup rather than inlined. | 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.