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' is abstract jargon that doesn't convey concrete capabilities. While it provides some trigger terms specific to the OpenProse ecosystem, it fails to explain what actions the skill performs or what outcomes it produces, making it difficult for Claude to confidently select this skill.
Suggestions
Replace 'orchestrates multi-agent workflows' with specific concrete actions the skill performs, e.g., 'parses .prose files, executes prose pipelines, manages agent delegation for text generation tasks'.
Add a clear 'Use when...' clause that covers both the technical triggers and natural language scenarios, e.g., 'Use when the user runs prose commands, references .prose files, or asks about OpenProse VM execution and pipeline management'.
Clarify the domain and output — what kind of results does this skill produce? Text documents, workflow outputs, agent configurations? This would significantly improve both specificity and distinctiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says 'orchestrates multi-agent workflows' which is vague and abstract. It does not list any concrete actions like 'generates documents', 'edits text', or 'formats prose'. 'Skill pack' is also non-descriptive. | 1 / 3 |
Completeness | The 'when' is partially addressed with 'Activate on any prose command, .prose files, or OpenProse mentions'. However, the 'what' is extremely weak — 'orchestrates multi-agent workflows' tells almost nothing about what the skill actually does or produces. | 2 / 3 |
Trigger Term Quality | It includes some trigger terms: 'prose command', '.prose files', 'OpenProse mentions'. These are somewhat useful but very niche/technical. A user would likely not naturally say 'OpenProse' or '.prose files' unless they already know the tool; common natural language triggers are missing. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'OpenProse', '.prose files', and 'prose command' provides some distinctiveness tied to a specific tool/ecosystem. However, 'multi-agent workflows' is generic enough to overlap with other orchestration or workflow 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 excels at actionability and progressive disclosure, serving as an effective routing document for a complex multi-file skill bundle. The workflow clarity is strong with proper validation checkpoints, especially for the PostgreSQL and migration flows. The main weakness is moderate redundancy across multiple file-location tables and some verbose sections (PostgreSQL setup, philosophical preamble) that could be trimmed or deferred to referenced files.
Suggestions
Consolidate the three overlapping file-location tables (File Locations, Core Documentation, and the state modes table) into a single reference table to reduce redundancy.
Move the detailed PostgreSQL setup instructions (Docker commands, connection checking) into state/postgres.md and keep only a brief pointer in SKILL.md, consistent with how other state backends are handled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but contains redundancy—file locations are listed in multiple tables (File Locations, Core Documentation) with overlapping information. The PostgreSQL setup section is quite verbose with inline bash examples that could be in the referenced state/postgres.md file. Some sections like the philosophical preamble about LLMs as simulators add flavor but not actionable value. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific command routing tables, exact file paths, executable bash commands for PostgreSQL setup, clear migration steps with before/after examples, resolution rules for remote programs, and specific example file mappings. Claude knows exactly what to do for each command. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints. The PostgreSQL setup has a 4-step process with connectivity verification before proceeding. Migration has numbered steps with clear before/after states and output formatting. The execution workflow (read prose.md → become VM → spawn sessions → narrate state) is well-sequenced. Remote program resolution has clear ordered rules. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure: SKILL.md serves as a clear routing/overview document pointing to co-located files (prose.md, compiler.md, help.md, state/*.md, guidance/*.md, examples/) with explicit guidance on when to load each file. References are one level deep and clearly signaled with 'When to Load' conditions. The context warning about compiler.md size shows awareness of token management. | 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 | |
a5bf5e0
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.