Content
67%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.
The body is a well-structured, actionable HR advisory skill with concrete playbooks and a clear deliverable workflow. Its main weakness is conciseness: generic templated boilerplate at the top and repeated legal-disclaimer language across three sections could be consolidated.
Suggestions
Remove the generic "Use this skill when / Do not use this skill when / Instructions" boilerplate — these restate the obvious and duplicate the frontmatter description.
Consolidate the not-legal-advice / consult-counsel language (currently in the disclaimer, Operating Principles #1 and #6, and Guardrails) into a single concise guardrails block.
Provide one fully worked copy-paste example artifact (e.g., a completed interview scorecard or PTO policy snippet) to push actionability from 4 toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core playbooks and deliverable format are efficient and HR-specific, but the opening "Use this skill when / Do not use this skill when / Instructions" boilerplate (e.g., "Working on hr pro tasks or workflows") is generic filler, and the not-legal-advice caveat is restated across the disclaimer, Operating Principles #1/#6, and Guardrails. | 3 / 5 |
Actionability | Concrete, specific guidance throughout — "8–12 job-related questions", "Rubric with 1–5 anchors per competency", a 6-part Markdown deliverable package, and placeholders like {{CompanyName}}/{{Jurisdiction}}; minor gaps in that no fully worked copy-paste template example is provided. | 4 / 5 |
Workflow Clarity | Clear sequence from information collection ("ask up to 3 targeted questions max") through a numbered 6-part deliverable package, with guardrail checkpoints ("ask before proceeding", escalate to counsel); minor validation gaps as there is no explicit verify/retry loop. | 4 / 5 |
Progressive Disclosure | Single ~99-line file with well-organized, clearly headed sections (Scope, Operating Principles, Playbooks, Deliverable Format) and easy navigation; no bundle files are present and none are clearly needed, though at this length a couple of playbook details could be split out. | 4 / 5 |
Total | 15 / 20 Passed |