Content
96%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-sequenced instruction skill: every step is executable, risky writes are guarded by explicit confirmation and no-overwrite rules, and edge cases (empty config, UUID routing, missing arguments) are covered. The only structural note is that the config-precedence detail is inline in an already-dense first step rather than split out.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: every sentence carries execution-critical detail (config precedence rules, UUID routing via `project_id`, frontmatter fields to add, example confirmation and output lines). There is no explanation of concepts Claude already knows and no padding. Matches the anchor "every token earns its place". | 5 / 5 |
Actionability | Guidance is fully concrete and executable for an instruction-only skill: exact config keys (`teamProjects`, `primaryProject`, `promoteFolder`), the routing rule ("if the team ref is an `external_id` UUID, pass it as `project_id`; otherwise pass the workspace-qualified name as `project`"), exact frontmatter field (`shared_from: <source permalink>`) and observation format, plus a sample output line. Per the rubric's scoring note, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit validation checkpoints around the risky write: stop if `teamProjects` is empty ("Don't invent a target"), confirm with the user before writing ("wait for a yes. Never share silently"), don't overwrite an existing note, and confirm the outcome with the new permalink. This matches the anchor's validate-before-proceed pattern with error paths (missing config, ambiguous source note) handled. | 5 / 5 |
Progressive Disclosure | The body is well-organized (Steps / Notes) with no dangling references, and there are no bundle files to score against. Not 5 because the rubric reserves a 5 for skills under 50 lines needing no external references; this body is ~60 lines, and the config-resolution detail in step 1 (environment-variable handling, settings precedence) is dense enough that it could live in a reference file if the skill grew. | 4 / 5 |
Total | 19 / 20 Passed |