Create a new monorepo package using the create-package CLI
73
58%
Does it follow best practices?
Impact
100%
1.31xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/create-package/SKILL.mdQuality
Discovery
32%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 concise and identifies a specific tool (create-package CLI) and domain (monorepo packages), but it lacks a 'Use when...' clause, lists only a single action, and misses common trigger term variations. It would benefit from explicit trigger guidance and more detail about what the skill covers.
Suggestions
Add a 'Use when...' clause with trigger terms like 'new package', 'scaffold package', 'add package to monorepo', 'create-package'.
Expand the capability description to list specific actions, e.g., 'Scaffolds new monorepo packages with correct directory structure, dependencies, and configuration using the create-package CLI'.
Include common user phrasing variations such as 'scaffold', 'initialize', 'add a new workspace package', or 'bootstrap package'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names a specific domain (monorepo package creation) and a specific tool (create-package CLI), but only describes one action rather than listing multiple concrete capabilities. | 2 / 3 |
Completeness | Describes what it does (create a monorepo package using create-package CLI) but has no explicit 'Use when...' clause or trigger guidance, which per the rubric caps completeness at 2, and the 'what' is also thin — scoring at 1 since both what and when are weak. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like 'monorepo', 'package', and 'create-package CLI' that users might say, but misses common variations like 'new package', 'scaffold', 'initialize', 'add package', or 'workspace package'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'create-package CLI' and 'monorepo' provides some specificity, but it could overlap with general package scaffolding or monorepo management skills without clearer trigger boundaries. | 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 solid, focused skill for a single-purpose task. It provides actionable, executable commands with a clear workflow. Minor verbosity in the Overview and Notes sections (repeating the @ocap/ prefix behavior, explaining what the CLI does) slightly reduces token efficiency but doesn't significantly detract from the overall quality.
Suggestions
Trim the Overview section to just the command purpose in one line, removing the bullet list explaining what the CLI does internally since Claude doesn't need to know implementation details.
Remove the duplicate mention of the @ocap/ prefix behavior—it appears in both Required Arguments and Notes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes some unnecessary explanation. The Overview section explaining what the CLI does (generating scaffolding, setting up structure) is somewhat redundant—Claude can infer this from the command itself. The Notes section repeats the prefix behavior already mentioned in Required Arguments. | 2 / 3 |
Actionability | Provides fully executable commands with concrete examples including the create-package command, adding dependencies, and updating tsconfig references. The bash examples are copy-paste ready with clear argument patterns. | 3 / 3 |
Workflow Clarity | The workflow is a simple 3-step process (ask user, run command, add dependencies) that is clearly sequenced. The additional step for TypeScript references when adding monorepo dependencies is a useful checkpoint. For this non-destructive, simple task, the workflow is sufficiently clear. | 3 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines, the content is well-organized with clear sections (Overview, Required Arguments, Usage Pattern, Example, Notes). No need for external file references given the scope. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d93dc41
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.