Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and actionable, with a clear sequenced workflow, an explicit external-vetting checkpoint, and concrete command shapes plus worked examples. Its only weakness is a few lines of provenance and justification that do not earn their place in the token budget.
Suggestions
Remove the "Source: salvaged from stale community PR #1232 by redminwang" provenance line; it does not help Claude execute the skill.
Tighten justifications such as "Local sources are preferred because they are already part of the user's environment" to a bare statement ("Prefer local sources.") and let the step ordering carry the rationale.
Optionally include one fully-worked search example with real keywords (not just the keyword|synonym placeholder) so a command is copy-paste runnable end-to-end.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with no concept explanations, but lines like "Source: salvaged from stale community PR #1232 by redminwang" and "Local sources are preferred because they are already part of the user's environment" add justification/provenance that could be tightened away. | 2 / 3 |
Actionability | It gives concrete, real command shapes (find, gh search repos, gh search code), a worked result table, and explicit ranking criteria; the literal keyword placeholders are justified by Step 1's keyword-capture step rather than being unjustified pseudocode. | 3 / 3 |
Workflow Clarity | A clear six-step sequence is given, and Step 4 is an explicit vetting checkpoint (read frontmatter, scan for unexpected shell/network/credential handling, review the diff) before any adoption, with creation gated on user choice or no-match. | 3 / 3 |
Progressive Disclosure | With no bundle files present, the body is organized into clear, well-labeled sections (When to Use, How It Works, Examples, Anti-Patterns, Related) with no nested references and no content that obviously needs to be split out. | 3 / 3 |
Total | 11 / 12 Passed |