Content
78%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 compact, well-structured instruction skill: inputs are enumerated, the output format is templated, and nothing pads the token budget. The main gaps are the placeholder-only offer letter text — the heart of the task — and the absence of verification checkpoints for comp figures before the draft is presented.
Suggestions
Replace the "[Complete offer letter text]" placeholder with a short skeleton of the actual letter (opening, role/comp recap, at-will language, closing) so the core deliverable is concretely specified.
Add an explicit checkpoint before drafting: confirm the provided comp figures with the user and verify the Total First-Year Comp row sums base, bonus, and first-year equity correctly.
Trim the Usage section (the slash-command invocation is already implied by the frontmatter argument-hint) to tighten the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — no explanation of what offer letters or comp packages are, and the output template is the core spec rather than padding. Minor trimmable instances remain: the Usage section restating the slash command and the conversational "If you don't have all details, I'll help you think through them". This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | The Output template is a concrete, fill-in-ready structure (comp table with named components, terms, benefits, letter text, manager notes) and the connectors section gives specific actions ("Pull comp band data", "Verify headcount approval"). However the core deliverable — the letter text itself — is left as "[Complete offer letter text]" with an ellipsis, a gap that keeps it below the fully-executable anchor. | 4 / 5 |
Workflow Clarity | The flow is legible from section order (gather inputs → draft from template → enrich via connectors → tips) and the single task is well-defined, but there are no explicit checkpoints such as confirming comp details with the user or verifying the Total First-Year Comp math before presenting the draft. This sits between 'sequence present but checkpoints missing or implicit' and the clear-sequence-with-checkpoints anchor, and the missing-verification cap for risky operations does not apply since drafting is non-destructive. | 4 / 5 |
Progressive Disclosure | The skill is self-contained with well-organized sections (Usage, inputs, Output, connectors, Tips) and no content that belongs in separate files; the only external pointer ([CONNECTORS.md](../../CONNECTORS.md)) is clearly signaled and one level deep. Per the rubric's guidance for simple skills with no need for external references, well-organized sections alone merit the top anchor. | 5 / 5 |
Total | 17 / 20 Passed |